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 函数将其销毁。

注意 Comctl32.dll 版本 6 不可再发行,但它包含在 Windows 或更高版本中。 若要使用 Comctl32.dll 版本 6,请在清单中指定它。 有关清单的详细信息,请参阅 启用视觉样式
 

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 commctrl.h
Library Comctl32.lib
DLL Comctl32.dll
API 集 Windows 10版本 10.0.14393 中引入的 ext-ms-win-shell-comctl32-init-l1-1-1 ()