ImageList_SetOverlayImage 函数 (commctrl.h)

  • 项目

将指定的图像添加到要用作覆盖掩码的图像列表中。 映像列表在版本 4.70 及更早版本中最多可以有 4 个覆盖掩码，在版本 4.71 中最多可以有 15 个覆盖掩码。 函数将覆盖掩码索引分配给指定的图像。

语法

BOOL ImageList_SetOverlayImage(
  [in] HIMAGELIST himl,
  [in] int        iImage,
  [in] int        iOverlay
);

参数

[in] himl

类型： HIMAGELIST

图像列表的句柄。

[in] iImage

类型： int

himl 图像列表中图像的从零开始的索引。 此索引标识要用作覆盖掩码的图像。

[in] iOverlay

类型： int

覆盖掩码的从 1 开始的索引。

返回值

类型： BOOL

如果成功，返回不为零的值；否则返回零。

注解

覆盖蒙板是在其他图像上透明绘制的图像。 若要在图像上绘制覆盖掩码，请调用 ImageList_Draw 或 ImageList_DrawEx 函数。 这些函数的 fStyle 参数可以使用 INDEXTOOVERLAYMASK 宏指定覆盖掩码索引。

除非使用掩码创建映像列表，否则对此方法的调用会失败并返回E_INVALIDARG。

要求

要求 值
最低受支持的客户端 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 ()