ImageList_DrawEx関数 (commctrl.h)
指定したデバイス コンテキストで画像リスト項目を描画します。 関数は、指定した描画スタイルを使用し、指定した色でイメージをブレンドします。
構文
BOOL ImageList_DrawEx(
HIMAGELIST himl,
int i,
HDC hdcDst,
int x,
int y,
int dx,
int dy,
COLORREF rgbBk,
COLORREF rgbFg,
UINT fStyle
);
パラメーター
himl
種類: HIMAGELIST
イメージ リストへのハンドル
i
型: int
描画するイメージのインデックス。
hdcDst
種類: HDC
ターゲット デバイス コンテキストのハンドル。
x
型: int
指定したデバイス コンテキスト内で描画する x 座標。
y
型: int
指定したデバイス コンテキスト内で描画する y 座標。
dx
型: int
画像の左上隅を基準にして描画する画像の部分の幅。 dx と dy が 0 の場合、関数はイメージ全体を描画します。 関数は、パラメーターが有効であることを確認しません。
dy
型: int
画像の左上隅を基準にして、描画する画像の部分の高さ。 dx と dy が 0 の場合、関数はイメージ全体を描画します。 関数は、パラメーターが有効であることを確認しません。
rgbBk
種類: COLORREF
イメージの背景色。 このパラメーターには、アプリケーション定義の RGB 値、または次のいずれかの値を指定できます。
| 値 | 意味 |
|---|---|
|
背景色なし。 イメージは透過的に描画されます。 |
|
既定の背景色。 イメージは、イメージ リストの背景色を使用して描画されます。 |
rgbFg
種類: COLORREF
イメージの前景色。 このパラメーターには、アプリケーション定義の RGB 値、または次のいずれかの値を指定できます。
| 値 | 意味 |
|---|---|
|
ブレンド色なし。 イメージは、ターゲット デバイス コンテキストの色とブレンドされます。 |
|
既定の前景色。 イメージは、システムの強調表示色を前景色として使用して描画されます。 |
fStyle
型: UINT
描画スタイルと、必要に応じてオーバーレイ イメージ。 オーバーレイイメージインデックスの指定については、このトピックの最後にあるコメントセクションを参照してください。 このパラメーターには、オーバーレイ イメージ インデックスと、次の 1 つ以上の値を組み合わせて使用できます。
戻り値
種類: 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 |