ImageList_LoadBitmap宏 (commctrl.h)

调用 ImageList_LoadImage 函数以从指定的位图资源创建图像列表。

语法

void ImageList_LoadBitmap(
   hi,
   lpbmp,
   cx,
   cGrow,
   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值,则不会生成掩码。

返回值

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 commctrl.h