ImageList_LoadBitmap マクロ (commctrl.h)

ImageList_LoadImage 関数を呼び出して、指定したビットマップ リソースからイメージ リストを作成します。

構文

HIMAGELIST ImageList_LoadBitmap(
   HINSTANCE hi,
   LPCTSTR   lpbmp,
   int       cx,
   int       cGrow,
   COLORREF  crMask
);

パラメーター

hi

型: HINSTANCE

ビットマップ リソースを含むインスタンスへのハンドル。 OEM ビットマップ 読み込む場合、このパラメーターは NULL です。

lpbmp

型: LPCTSTR

読み込むイメージ。 hi パラメーターが null以外の場合、lpbmp は、hi モジュール内のイメージ リソースの名前を含む null で終わる文字列のアドレスです。 hi が NULL場合、このパラメーターの LOWORD は、読み込む OEM ビットマップの識別子である必要があります。 この値を作成するには、MAKEINTRESOURCE マクロを使用し、WINUSER.H で定義されている OEM ビットマップ識別子のいずれかを指定します。 これらの識別子には、OBM_ プレフィックスがあります。

cx

型: int

各イメージの幅。 各イメージの高さと画像の初期数は、指定されたビットマップの寸法によって推論されます。

cGrow

型: int

システムが新しいイメージ用の領域を作成する必要があるときに、イメージ リストを拡大できるイメージの数。 このパラメーターは、サイズ変更されたイメージ リストに含めることができる新しいイメージの数を表します。

crMask

型: COLORREF

マスクの生成に使用される色。 指定されたビットマップ内のこの色の各ピクセルが黒に変更され、マスク内の対応するビットが 1 に設定されます。 このパラメーターがCLR_NONE値の場合、マスクは生成されません。

戻り値

型: HIMAGELIST

成功した場合はイメージ リストにハンドルを返し、それ以外の場合は NULL します。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	commctrl.h