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

ImageAttributes::ClearColorMatrix メソッドは、指定したカテゴリの色調整マトリックスをクリアします。

構文

Status ClearColorMatrix(
  [in, optional] ColorAdjustType type
);

パラメーター

[in, optional] type

種類: ColorAdjustType

色調整マトリックスをクリアするカテゴリを指定する ColorAdjustType 列挙体の要素。 既定値は ColorAdjustTypeDefault です。

戻り値

種類: 状態

メソッドが成功した場合は、Status 列挙の要素である Ok を返します。

メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。

解説

ImageAttributes オブジェクトは、既定、ビットマップ、ブラシ、ペン、テキストの 5 つの調整カテゴリの色とグレースケールの設定を維持します。 たとえば、既定のカテゴリの色調整マトリックス、ビットマップ カテゴリに異なる色調整マトリックス、およびペン カテゴリに異なる色調整マトリックスを指定できます。

既定の色調整とグレースケール調整設定は、独自の調整設定を持たないすべてのカテゴリに適用されます。 たとえば、ペン カテゴリの調整設定を指定しない場合、既定の設定はペン カテゴリに適用されます。

特定のカテゴリに対して色調整またはグレースケール調整設定を指定するとすぐに、既定の調整設定がそのカテゴリに適用されなくなります。 たとえば、既定のカテゴリに色調整行列とガンマ値を指定するとします。 ImageAttributes::SetColorMatrix を呼び出してペン カテゴリの色調整マトリックスを設定した場合、既定の色調整マトリックスはペンには適用されません。 後で ImageAttributes::ClearColorMatrix を呼び出してペンの色調整マトリックスをクリアした場合、ペン カテゴリは既定の調整マトリックスに戻りません。むしろ、ペンカテゴリには調整マトリックスはありません。 同様に、ペン カテゴリは既定のガンマ値に戻りません。むしろ、ペンカテゴリにはガンマ値はありません。

要件

サポートされている最小のクライアント	Windows XP、Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	gdiplusimageattributes.h (Gdiplus.h を含む)
Library	Gdiplus.lib
[DLL]	Gdiplus.dll

関連項目

Bitmap

Color

ColorAdjustType

ColorMatrix

イメージ

ImageAttributes

ImageAttributes::ClearColorMatrices

ImageAttributes::SetColorMatrices

ImageAttributes::SetColorMatrix

ImageAttributes::SetToIdentity

メタファイル

色変更