ImageAttributes::SetColorMatrices メソッド (gdiplusimageattributes.h)
ImageAttributes::SetColorMatrices メソッドは、指定したカテゴリの色調整マトリックスとグレースケール調整マトリックスを設定します。
構文
Status SetColorMatrices(
[in] const ColorMatrix *colorMatrix,
[in] const ColorMatrix *grayMatrix,
[in, optional] ColorMatrixFlags mode,
[in, optional] ColorAdjustType type
);
パラメーター
[in] colorMatrix
型: const ColorMatrix*
5×5 色調整マトリックスへのポインター。
[in] grayMatrix
型: const ColorMatrix*
5×5 グレースケール調整マトリックスへのポインター。
[in, optional] mode
種類: ColorMatrixFlags
色調整マトリックスとグレースケール調整マトリックスの影響を受けるイメージと色の種類を指定する ColorMatrixFlags 列挙体の要素。 既定値は ColorMatrixFlagsDefault です。
[in, optional] type
種類: ColorAdjustType
色調整マトリックスとグレースケール調整マトリックスを設定するカテゴリを指定する ColorAdjustType 列挙体の要素。 既定値は ColorAdjustTypeDefault です。
戻り値
種類: 状態
メソッドが成功した場合は、Status 列挙の要素である Ok を返します。
メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。
注釈
ImageAttributes オブジェクトは、既定、ビットマップ、ブラシ、ペン、テキストの 5 つの調整カテゴリの色とグレースケールの設定を維持します。 たとえば、既定のカテゴリの調整マトリックス、ビットマップ カテゴリに異なる調整マトリックス、およびペン カテゴリに対して異なる調整マトリックスを指定できます。
既定の色調整とグレースケール調整設定は、独自の調整設定を持たないすべてのカテゴリに適用されます。 たとえば、ペン カテゴリの調整設定を指定しない場合、既定の設定はペン カテゴリに適用されます。
特定のカテゴリに対して色調整またはグレースケール調整設定を指定するとすぐに、既定の調整設定がそのカテゴリに適用されなくなります。 たとえば、既定のカテゴリの調整設定のコレクションを指定するとします。 ColorAdjustTypePen を ImageAttributes::SetColorMatrices メソッドに渡して、ペン カテゴリの色調整マトリックスとグレースケール調整マトリックスを設定した場合、既定の調整設定はペンに適用されません。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP、Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | gdiplusimageattributes.h (Gdiplus.h を含む) |
Library | Gdiplus.lib |
[DLL] | Gdiplus.dll |
こちらもご覧ください
ImageAttributes::ClearColorMatrices
ImageAttributes::ClearColorMatrix
ImageAttributes::SetColorMatrix