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 ()