ImageList_Create 関数 (commctrl.h)

新しいイメージ リストを作成します。

構文

HIMAGELIST ImageList_Create(
  int  cx,
  int  cy,
  UINT flags,
  int  cInitial,
  int  cGrow
);

パラメーター

cx

型: int

各イメージの幅 (ピクセル単位)。

cy

型: int

各画像の高さ (ピクセル単位)。

flags

型: UINT

作成するイメージ リストの種類を指定するビット フラグのセット。 このパラメーターには、 イメージ リスト作成フラグの組み合わせを指定できます。

cInitial

型: int

イメージ リストに最初に含まれるイメージの数。

cGrow

型: int

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

戻り値

種類: HIMAGELIST

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

解説

イメージ リストの使用が完了したら、 ImageList_Destroy 関数を呼び出して破棄します。

バージョン 6 Comctl32.dll 再頒布可能ではありませんが、Windows 以降に含まれていることに注意してください。 バージョン 6 Comctl32.dll 使用するには、マニフェストで指定します。 マニフェストの詳細については、「 ビジュアル スタイルの有効化」を参照してください。

 

要件

サポートされている最小のクライアント	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 で導入)