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

[アーティクル]
02/26/2024

ImageAttributes::ClearOutputChannel メソッドは、指定したカテゴリのシアン-マゼンタ-イエローブラック (CMYK) 出力チャネル設定をクリアします。

構文

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

パラメーター

[in, optional] type

種類: ColorAdjustType

出力チャネル設定をクリアするカテゴリを指定する ColorAdjustType 列挙体の要素。既定値は ColorAdjustTypeDefault です。

戻り値

種類: 状態

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

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

注釈

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

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

特定のカテゴリに対してカラーまたはグレースケールの調整設定を指定するとすぐに、既定の調整設定はそのカテゴリに適用されなくなります。たとえば、既定のカテゴリに出力チャネルと調整マトリックスを指定するとします。 ImageAttributes::SetOutputChannel を呼び出してビットマップカテゴリの出力チャネルを設定した場合、既定の出力チャネルはビットマップには適用されません。 後で ImageAttributes::ClearOutputChannel を呼び出してビットマップ出力チャネルをクリアした場合、ビットマップカテゴリは既定の出力チャネルに戻りません。代わりに、ビットマップカテゴリには出力チャネルの設定はありません。同様に、ビットマップカテゴリは既定の色調整マトリックスに戻りません。代わりに、ビットマップカテゴリには色調整マトリックスはありません。

要件

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