ImageList_AddMasked 函数 (commctrl.h)

  • 项目

将一个或多个图像添加到图像列表，从指定的位图生成掩码。

语法

int ImageList_AddMasked(
  HIMAGELIST himl,
  HBITMAP    hbmImage,
  COLORREF   crMask
);

参数

himl

类型： HIMAGELIST

图像列表的句柄。

hbmImage

类型： HBITMAP

包含一个或多个图像的位图的句柄。 图像数是从位图的宽度推断出来的。

crMask

类型： COLORREF

用于生成掩码的颜色。 指定位图中此颜色的每个像素都更改为黑色，掩码中的相应位设置为 1。 如果此参数为CLR_DEFAULT，则使用 (0，0) 的像素颜色作为掩码。

返回值

类型： int

如果成功，则返回第一个新映像的索引，否则返回 -1。

注解

ImageList_AddMasked 函数将位图复制到内部数据结构。 不支持颜色深度大于 8bpp 的位图。 请务必在函数返回后使用 DeleteObject 函数删除 hbmImage 。

要求

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