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 つ以上の値を組み合わせて使用できます。
値 | 意味 |
---|---|
|
|
|
イメージを描画し、25% とシステムの強調表示色をブレンドします。 イメージ リストにマスクが含まれていない場合、この値は無効です。 |
|
イメージを描画し、50% とシステムの強調表示の色をブレンドします。 イメージ リストにマスクが含まれていない場合、この値は無効です。 |
|
|
|
オーバーレイでマスクを描画する必要がない場合は、このフラグを設定します。 このフラグにより、 ImageList_DrawEx はマスクを無視してイメージだけを描画します。 |
|
マスクを描画します。 |
|
イメージ リストの背景色を使用してイメージを描画します。 背景色がCLR_NONE値の場合、イメージはマスクを使用して透過的に描画されます。 |
|
|
|
背景色に関係なく、マスクを使用してイメージを透過的に描画します。 イメージ リストにマスクが含まれていない場合、この値は無効です。 |
戻り値
種類: 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 で導入) |