ImageAttributes.SetThresholdとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ImageAttributes.SetThreshold メソッド (Single)

既定のカテゴリのしきい値 (透明度の範囲) を指定します。

名前空間: System.Drawing.Imaging
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Sub SetThreshold ( _
    threshold As Single _
)

Visual Basic (使用法)

Dim instance As ImageAttributes
Dim threshold As Single

instance.SetThreshold(threshold)

public void SetThreshold (
    float threshold
)

C++

public:
void SetThreshold (
    float threshold
)

public void SetThreshold (
    float threshold
)

JScript

public function SetThreshold (
    threshold : float
)

パラメータ

threshold: しきい値を指定する実数。

戻り値
このメソッドは値を返しません。

解説

しきい値は、色の各要素のカットオフポイントを指定する 0 ～ 1 の範囲の値です。たとえば、しきい値が 0.7 に設定されているとき、赤、緑、青の要素がそれぞれ 230、50、および 220 である色をレンダリングするとします。赤の要素は 230 で、0.7 × 255 より大きいため、255 (最大輝度) に変更されます。緑の要素は 50 で、0.7 × 255 より小さいため、緑の要素は 0 に変更されます。青の要素は 220 で、0.7 × 255 より大きいため、青の要素は 255 に変更されます。

ImageAttributes オブジェクトは、5 つの調整カテゴリ (既定、ビットマップ、ブラシ、ペン、テキスト) に関して色とグレースケールの設定を保持します。たとえば、既定のカテゴリに対してしきい値を指定し、ビットマップカテゴリには別のしきい値を指定し、さらにペンカテゴリにも異なるしきい値を指定できます。

既定のカラー調整設定値およびグレースケール調整設定値は、調整設定値が設定されていないすべてのカテゴリに対して適用されます。たとえば、ペンカテゴリの調整設定を一切指定していない場合、ペンカテゴリには既定の設定が適用されます。

使用例

次の例は、Windows フォームでの使用を意図してデザインされており、Paint イベントハンドラのパラメータである PaintEventArgse が必要です。このコードは次のアクションを実行します。

Image を開き、それを画面に描画します。
ImageAttributes オブジェクトを作成し、SetThreshold メソッドを使用して、そのオブジェクトのしきい値を設定します。
ImageAttributes オブジェクトのしきい値を使用して、イメージを画面に描画します。

Visual Basic

Public Sub SetThresholdExample(ByVal
 e As PaintEventArgs)

    ' Open an Image file, and draw it to the screen.
    Dim myImage As Image = Image.FromFile("Camera.jpg")
    e.Graphics.DrawImage(myImage, 20, 20)

    ' Create an ImageAttributes object, and set its color threshold.
    Dim imageAttr As New
 ImageAttributes
    imageAttr.SetThreshold(0.7F)

    ' Draw the image with the colors bifurcated.
    Dim rect As New Rectangle(300,
 20, 200, 200)
    e.Graphics.DrawImage(myImage, rect, 0, 0, 200, 200, _
    GraphicsUnit.Pixel, imageAttr)
End Sub

private void SetThresholdExample(PaintEventArgs
 e)
{
             
    // Open an Image file, and draw it to the screen.
    Image myImage = Image.FromFile("Camera.jpg");
    e.Graphics.DrawImage(myImage, 20, 20);
             
    // Create an ImageAttributes object, and set its color threshold.
    ImageAttributes imageAttr = new ImageAttributes();
    imageAttr.SetThreshold(0.7f);
             
    // Draw the image with the colors bifurcated.
    Rectangle rect = new Rectangle(300, 20, 200, 200);
    e.Graphics.DrawImage(myImage, rect, 0, 0, 200, 200, 
        GraphicsUnit.Pixel, imageAttr);    
}

C++

void SetThresholdExample( PaintEventArgs^ e )
{
   // Open an Image file, and draw it to the screen.
   Image^ myImage = Image::FromFile( "Camera.jpg" );
   e->Graphics->DrawImage( myImage, 20, 20 );

   // Create an ImageAttributes object, and set its color threshold.
   ImageAttributes^ imageAttr = gcnew ImageAttributes;
   imageAttr->SetThreshold( 0.7f );

   // Draw the image with the colors bifurcated.
   Rectangle rect = Rectangle(300,20,200,200);
   e->Graphics->DrawImage( myImage, rect, 0, 0, 200, 200, GraphicsUnit::Pixel,
 imageAttr );
}

private void SetThresholdExample(PaintEventArgs
 e)
{
    // Open an Image file, and draw it to the screen.
    Image myImage = Image.FromFile("Camera.jpg");

    e.get_Graphics().DrawImage(myImage, 20, 20);

    // Create an ImageAttributes object, and set its color threshold.
    ImageAttributes imageAttr = new ImageAttributes();

    imageAttr.SetThreshold(0.7F);

    // Draw the image with the colors bifurcated.
    Rectangle rect = new Rectangle(300, 20, 200, 200);

    e.get_Graphics().DrawImage(myImage, rect, 0, 0, 200, 200, 
        GraphicsUnit.Pixel, imageAttr);
} //SetThresholdExample

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ImageAttributes クラス
ImageAttributes メンバ
System.Drawing.Imaging 名前空間

ImageAttributes.SetThreshold メソッド (Single, ColorAdjustType)

指定したカテゴリのしきい値 (透明度の範囲) を設定します。

名前空間: System.Drawing.Imaging
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Sub SetThreshold ( _
    threshold As Single, _
    type As ColorAdjustType _
)

Visual Basic (使用法)

Dim instance As ImageAttributes
Dim threshold As Single
Dim type As ColorAdjustType

instance.SetThreshold(threshold, type)

public void SetThreshold (
    float threshold,
    ColorAdjustType type
)

C++

public:
void SetThreshold (
    float threshold, 
    ColorAdjustType type
)

public void SetThreshold (
    float threshold, 
    ColorAdjustType type
)

JScript

public function SetThreshold (
    threshold : float, 
    type : ColorAdjustType
)

パラメータ

threshold: 最大値または最小値に変換する色の並べ替えのためのブレークポイントとして使用される、0.0 ～ 1.0 の範囲内のしきい値。

type: 色のしきい値を設定する対象のカテゴリを指定する ColorAdjustType の要素。

戻り値
このメソッドは値を返しません。

解説

特定のカテゴリに対してカラー調整設定値またはグレースケール調整設定値を指定すると、そのカテゴリに適用されていた既定の調整設定値は解除されます。たとえば、既定のカテゴリに対して調整設定値のコレクションを指定するとします。Pen を SetThreshold メソッドに渡してペンカテゴリのしきい値を設定すると、ペンには既定の調整設定は一切適用されません。

使用例

コード例については、SetThreshold(Single) メソッドのトピックを参照してください。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ImageAttributes クラス
ImageAttributes メンバ
System.Drawing.Imaging 名前空間

ImageAttributes.SetThreshold メソッド

しきい値 (透明度の範囲) を設定します。
オーバーロードの一覧

名前	説明
ImageAttributes.SetThreshold (Single)	既定のカテゴリのしきい値 (透明度の範囲) を指定します。
ImageAttributes.SetThreshold (Single, ColorAdjustType)	指定したカテゴリのしきい値 (透明度の範囲) を設定します。

参照

ImageAttributes.SetThresholdとは？わかりやすく解説

ImageAttributes.SetThreshold メソッド (Single)

ImageAttributes.SetThreshold メソッド (Single, ColorAdjustType)

ImageAttributes.SetThreshold メソッド

関連項目

英和和英テキスト翻訳

「ImageAttributes.SetThreshold」の関連用語


	© 2026 Microsoft.All rights reserved.

ImageAttributes.SetThresholdとは？ わかりやすく解説

ImageAttributes.SetThreshold メソッド (Single)

ImageAttributes.SetThreshold メソッド (Single, ColorAdjustType)

ImageAttributes.SetThreshold メソッド

関連項目

英和和英テキスト翻訳

「ImageAttributes.SetThreshold」の関連用語

ImageAttributes.SetThresholdとは？わかりやすく解説