Share via

IImageList::SetBkColor メソッド (commoncontrols.h)

  • [アーティクル]

イメージ リストの背景色を設定します。 このメソッドは、イメージ リストにアイコンを追加する場合、または IImageList::AddMasked メソッドを使用して白黒ビットマップを追加する場合にのみ機能します。 マスクがないと、イメージ全体が描画され、背景色は表示されません。

構文

HRESULT SetBkColor(
  [in]  COLORREF clrBk,
  [out] COLORREF *pclr
);

パラメーター

[in] clrBk

種類: COLORREF

設定する背景色。 このパラメーターが CLR_NONE に設定されている場合、イメージは マスクを使用して透過的に描画されます。

[out] pclr

種類: COLORREF*

成功した場合は戻り値の前の背景色を含む COLORREF へのポインター。それ以外の場合はCLR_NONE。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

IImageList::SetBkColor を使用するには、マニフェスト Comctl32.dll バージョン 6 を指定します。 マニフェストの詳細については、「 ビジュアル スタイルの有効化」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー commoncontrols.h
[DLL] Comctl32.dll (バージョン 6.0 以降)