ImageList_LoadImageW

指定されたビットマップからイメージリストを作成する。(Unicode)

ImageList_LoadImageW hi, lpbmp, cx, cGrow, crMask, uType, uFlags

hi : [intptr] 型: HINSTANCE リソースを含むインスタンスへのハンドル。ファイルから画像を読み込む場合や OEM リソースを読み込む場合、このパラメータは NULL を指定できる。
lpbmp : [wstr] 型: LPCTSTR 読み込む画像。uFlags パラメータに LR_LOADFROMFILE が含まれている場合、lpbmp は読み込む画像を含むファイルの名前を表す NULL 終端文字列のアドレスである。hi パラメータが NULL でなく、LR_LOADFROMFILE が指定されていない場合、lpbmp は hi モジュール内の画像リソースの名前を含む NULL 終端文字列のアドレスである。hi が NULL で LR_LOADFROMFILE が指定されていない場合、このパラメータの LOWORD は読み込む OEM 画像の識別子でなければならない。この値を作成するには、Winuser.h で定義された OEM 画像識別子のいずれかを MAKEINTRESOURCE マクロで使用する。これらの識別子には次のプレフィックスが付いている。
cx : [int] 型: int 各画像の幅。各画像の高さと画像の初期個数は、指定されたリソースの寸法から推測される。
cGrow : [int] 型: int 新しい画像のための領域が必要になったときにイメージリストを拡張できる画像数。このパラメータは、サイズ変更後のイメージリストに含めることができる新しい画像の数を表す。
crMask : [int] 型: COLORREF マスクの生成に使用する色。指定されたビットマップ、カーソル、アイコンのこの色の各ピクセルは黒に変更され、対応するマスクのビットが 1 に設定される。このパラメータが CLR_NONE の場合、マスクは生成されない。このパラメータが CLR_DEFAULT の場合、画像の左上隅のピクセルの色がマスクの色として扱われる。
uType : [int] 型: UINT 読み込む画像の種類を指定するフラグ。このパラメータは、ビットマップを読み込むことを示すために IMAGE_BITMAP でなければならない。
uFlags : [int] 型: UINT

(プラグイン / モジュール : comctl32.dll)

解説

指定されたビットマップからイメージリストを作成する。(Unicode)

[戻り値]
型: HIMAGELIST 成功した場合はイメージリストへのハンドルを返し、それ以外は NULL を返す。

[備考]
LR_LOADTRANSPARENT は画像を透過的に読み込むわけではない。すべての背景ピクセルが COLOR_WINDOW
に変更されているために透過に見える不透明なイメージリストを作成する。画像が COLOR_WINDOW
以外の背景色の上に描画されると、画像は正しく描画されない。また、LR_LOADTRANSPARENT と
LR_LOADMAP3DCOLORS は、ImageList_LoadImage
が呼び出された時点で有効だったシステムカラーを使用する。その後システムカラーが変更された場合、アプリケーションは色を再マッピングするために画像を再読み込みする必要がある。
> [!NOTE] > commctrl.h ヘッダは ImageList_LoadImage
をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に応じて ANSI または Unicode
版を自動的に選択する。エンコーディング中立でないコードと中立エイリアスを混在させると、コンパイルまたは実行時エラーにつながる不整合が生じる可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報