ImageList_GetIcon

イメージリストのイメージとマスクからアイコンを作成します。

HICON ImageList_GetIcon(
    HIMAGELIST himl,   // イメージリストのハンドル
    int        index,  // イメージのインデックス
    UINT       flags   // 描画スタイル
);

COMCTL32.DLL

引数

himl

イメージリストのハンドルを指定します。

index

描画するイメージのインデックスを指定します。

flags

描画スタイルを指定します。描画スタイルは以下の値の組み合わせで指定します。

意味
0x0000 (ILD_NORMAL)

イメージリストのバックグラウンドカラーを使用してイメージを描画します。バックグラウンドカラーが CLR_NONE (0xFFFFFFFF) ならば、イメージはマスクを使用して透明に描画されます。

0x0001 (ILD_TRANSPARENT)

イメージリストのバックグラウンドカラーに関係なく、マスクを使用して透明に描画されます。マスクを使用しない場合はこのフラグは無視されます。

0x0002 (ILD_BLEND25, ILD_FOCUS)

システムの強調表示色を 25% 混合して、イメージを描画します。イメージリストがマスクを持っていないときは、この値は有効ではありません。

0x0004 (ILD_BLEND50, ILD_SELECTED, ILD_BLEND)

システムの強調表示色を 50% 混合して、イメージを描画します。イメージリストがマスクを持っていないときは、この値は有効ではありません。

0x0010 (ILD_MASK)

マスクを描画します。

戻り値

成功すると、作成されたアイコンのハンドルが返ります。

失敗すると 0 (NULL) が返ります。

解説

アイコンが不要になったら、 DestroyIcon 関数を呼び出してアイコンハンドルを破棄しなければなりません。

対応情報

Windows 95 以降 / Windows NT 3.51 以降