ImageList_LoadImage函数从指定的位图,光标或图标资源创建一个图像列表。
HIMAGELIST ImageList_LoadImage(
HINSTANCE 【hi】, | |
LPCSTR 【lpbmp】, | |
INT 【cx】, | |
INT 【cGrow】, | |
COLORREF 【crMask】, | |
UINT 【UTYPE】, | |
UINT 【uFlags】 | |
); |
参数
【hi】
处理包含资源的实例。
如果【hi】参数为零,则此参数的低位字必须是要加载的OEM映像的标识符。OEM图像标识符在WINUSER.H中定义。以下是标识符前缀及其含义:
字首 | 含义 |
OBM_ | OEM位图 |
OIC_ | OEM图标 |
OCR_ | OEM光标 |
【lpbmsp】
指向包含要加载的映像名称的以null结尾的字符串。
如果【uFlags】参数指定LR_LOADFROMFILE值,则【lpbmp】参数必须是包含映像的文件的名称。
【cx】
每张图片的宽度。每个图像的高度和图像的初始数量由指定资源的维度推断。
【cGrow】
当系统需要调整列表大小以为新图像腾出空间时,图像列表可以增长的图像数量。此参数表示调整大小的图像列表可以包含的新图像的数量。
【crMask】
用于生成面具的颜色。指定位图,光标或图标中此颜色的每个像素都变为黑色,掩码中的相应位设置为1。如果此参数为CLR_NONE值,则不生成掩码。
【UTYPE】
指定要加载的图像类型的标志。此参数可以是以下值之一:
值 | 含义 |
IMAGE_BITMAP | 加载位图 |
IMAGE_CURSOR | 加载光标。 |
IMAsssGE_ICON | 加载图标。 |
【uFlags】
指定如何加载映像的标志。此参数可以是以下值的组合:
值 | 含义 |
LR_DEFAULTCOLOR | 使用显示屏的颜色格式。 |
LR_LOADDEFAULTSIZE | 如果【cx】参数设置为零,则使用由游标和图标的系统度量值指定的宽度或高度。如果未指定此值并将【cx】设置为零,则该函数将大小设置为资源中指定的大小。如果资源包含多个图像,则该函数将大小设置为第一个图像的大小。 |
LR_LOADFROMFILE | 从【lpbmp】参数指定的文件加载图像。 |
LR_LOADMAP3DCOLORS | 搜索图像的颜色表,并用相应的三维颜色替换以下灰色阴影: |
Dk Gray, RGB(128, 128, 128) | COLOR_3DSHADOW |
灰色, RGB(192, 192, 192) | COLOR_3DFACE |
Lt灰色, RGB(223, 223, 223) | COLOR_3DLIGHT |
LR_LOADTRANSPARENT | 检索图像中第一个像素的颜色值,并使用默认窗口颜色(COLOR_WINDOW显示颜色)替换颜色表中的相应条目。使用该条目的图像中的所有像素都将成为默认窗口值颜色。此值仅适用于具有相应颜色表的图像。 |
LR_MONOCHROME | 加载黑白图像。 |
LR_SHARED | 如果图像被加载多次,则共享图像句柄。不要将此值用于加载后可能会更改的非传统尺寸或从文件加载的图像的图像。 |
返回值
如果函数成功,则返回值是图像列表的句柄。
如果函数失败,返回值为NULL。
也可以看看