ImageAttributes::Reset メソッド (gdiplusimageattributes.h)
ImageAttributes::Reset メソッドは、指定されたカテゴリのすべての色調整とグレースケール調整設定をクリアします。
構文
Status Reset(
[in, optional] ColorAdjustType type
);
パラメーター
[in, optional] type
種類: ColorAdjustType
色の調整がリセットされるカテゴリを指定する ColorAdjustType 列挙体の要素。 既定値は ColorAdjustTypeDefault です。
戻り値
種類: 状態
メソッドが成功した場合は、Status 列挙の要素である Ok を返します。
メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。
解説
ImageAttributes オブジェクトは、既定、ビットマップ、ブラシ、ペン、テキストの 5 つの調整カテゴリの色とグレースケールの設定を維持します。 たとえば、既定のカテゴリにガンマ値を指定したり、ビットマップ カテゴリに異なるガンマ値を指定したり、ペン カテゴリに異なるガンマ値を指定したりできます。
既定の色調整とグレースケール調整設定は、独自の調整設定を持たないすべてのカテゴリに適用されます。 たとえば、ペン カテゴリの調整設定を指定しない場合、既定の設定はペン カテゴリに適用されます。
特定のカテゴリに対して色調整またはグレースケール調整設定を指定するとすぐに、既定の調整設定がそのカテゴリに適用されなくなります。 ImageAttributes::Reset を呼び出すことで、そのカテゴリの既定の設定を元に戻すことができます。 たとえば、既定のカテゴリにガンマ値を指定するとします。 ImageAttributes::SetGamma を呼び出してペン カテゴリのガンマ値を設定した場合、既定のガンマ値はペンには適用されません。 後で ColorAdjustTypePen を ImageAttributes::Reset メソッドに渡すと、ペン カテゴリは既定のガンマ値に戻ります。
要件
| サポートされている最小のクライアント | Windows XP、Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | gdiplusimageattributes.h (Gdiplus.h を含む) |
| Library | Gdiplus.lib |
| [DLL] | Gdiplus.dll |