通过

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 终止字符串的地址。 如果 hiNULL，则此参数的 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