指定したカテゴリのカラー調整行列を設定します。
Overloads Public Sub SetColorMatrix( _
ByVal newColorMatrix As ColorMatrix, _ ByVal mode As ColorMatrixFlag, _ ByVal type As ColorAdjustType _)
[C#]
public void SetColorMatrix(ColorMatrixnewColorMatrix,ColorMatrixFlagmode,ColorAdjustTypetype);
[C++]
public: void SetColorMatrix(ColorMatrix* newColorMatrix,ColorMatrixFlagmode,ColorAdjustTypetype);
[JScript]
public function SetColorMatrix(
newColorMatrix : ColorMatrix,mode : ColorMatrixFlag,type : ColorAdjustType);
パラメータ
- newColorMatrix
カラー調整行列。 - mode
カラー調整行列の影響を受けるイメージと色の種類を指定する ColorMatrixFlag 列挙体の要素。 - type
カラー調整行列を設定する対象のカテゴリを指定する ColorAdjustType 列挙体の要素。
戻り値
このメソッドは値を返しません。
解説
ImageAttributes オブジェクトは、5 つの調整カテゴリ (既定、ビットマップ、ブラシ、ペン、テキスト) に関して色とグレースケールの設定を保持します。たとえば、既定のカテゴリにあるカラー調整行列を指定し、ビットマップ カテゴリには別のカラー調整行列を指定し、さらにペン カテゴリにも異なるカラー調整行列を指定できます。
既定のカラー調整設定値およびグレースケール調整設定値は、調整設定値が設定されていないすべてのカテゴリに対して適用されます。たとえば、ペン カテゴリの調整設定を一切指定していない場合、ペン カテゴリには既定の設定が適用されます。
特定のカテゴリに対してカラー調整設定値またはグレースケール調整設定値を指定すると、そのカテゴリに適用されていた既定の調整設定値は解除されます。たとえば、既定のカテゴリに対して調整設定値のコレクションを指定するとします。ColorAdjustTypePen.Pen を SetColorMatrix メソッドに渡してペン カテゴリのカラー調整行列を設定すると、ペンには既定の調整設定は一切適用されません。
使用例
例については、 ImageAttributes.SetColorMatrix Method (ColorMatrix) のトピックを参照してください。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
参照
ImageAttributes クラス | ImageAttributes メンバ | System.Drawing.Imaging 名前空間 | ImageAttributes.SetColorMatrix オーバーロードの一覧