ImageList_Draw 関数 (commctrl.h)

  • [アーティクル]

指定したデバイス コンテキストでイメージ リスト 項目を描画します。

構文

BOOL ImageList_Draw(
  HIMAGELIST himl,
  int        i,
  HDC        hdcDst,
  int        x,
  int        y,
  UINT       fStyle
);

パラメーター

himl

種類: HIMAGELIST

イメージ リストへのハンドル。

i

型: int

描画するイメージの 0 から始まるインデックス。

hdcDst

種類: HDC

ターゲット デバイス コンテキストのハンドル。

x

型: int

指定したデバイス コンテキスト内で描画する x 座標。

y

型: int

指定したデバイス コンテキスト内で描画する y 座標。

fStyle

型: UINT

描画スタイルと、必要に応じてオーバーレイ イメージ。 オーバーレイ イメージ インデックスの指定については、このトピックの最後にある「コメント」セクションを参照してください。 このパラメーターには、オーバーレイ イメージ インデックスと、次の 1 つ以上の値を組み合わせて使用できます。

値 意味
ILD_BLEND
ILD_BLEND25
 イメージを描画し、25% とシステムの強調表示色をブレンドします。 イメージ リストにマスクが含まれていない場合、この値は無効です。
ILD_BLEND50
 イメージを描画し、50% とシステムの強調表示の色をブレンドします。 イメージ リストにマスクが含まれていない場合、この値は無効です。
ILD_FOCUS
ILD_IMAGE
 オーバーレイでマスクを描画する必要がない場合は、このフラグを設定します。 このフラグにより、 ImageList_DrawEx はマスクを無視してイメージだけを描画します。
ILD_MASK
 マスクを描画します。
ILD_NORMAL
 イメージ リストの背景色を使用してイメージを描画します。 背景色がCLR_NONE値の場合、イメージはマスクを使用して透過的に描画されます。
ILD_SELECTED
ILD_TRANSPARENT
 背景色に関係なく、マスクを使用してイメージを透過的に描画します。 イメージ リストにマスクが含まれていない場合、この値は無効です。

戻り値

種類: BOOL

成功した場合は 0 以外、それ以外の場合は 0 を返します。

解説

オーバーレイ イメージは、 i パラメーターで指定されたプライマリ イメージの上に透過的に描画されます。 fStyle パラメーターでオーバーレイ イメージを指定するには、INDEXTOOVERLAYMASK マクロを使用して、オーバーレイ イメージの 1 から始まるインデックスをシフトします。 OR 演算子を使用して、マクロの戻り値と fStyle パラメーターで指定された描画スタイル フラグを論理的に結合します。 最初に 、ImageList_SetOverlayImage 関数を使用して、このイメージをオーバーレイ イメージとして指定する必要があります。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー commctrl.h
Library Comctl32.lib
[DLL] Comctl32.dll
API セット ext-ms-win-shell-comctl32-init-l1-1-1 (Windows 10 バージョン 10.0.14393 で導入)