ImageAttributes::SetColorMatrices メソッド (gdiplusimageattributes.h)

[アーティクル]
08/24/2023

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