IImageList：：SetOverlayImage 方法 (commoncontrols.h)

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

语法

HRESULT SetOverlayImage(
  [in] int iImage,
  [in] int iOverlay
);

[in] iImage

类型： int

int 类型的值，包含图像列表中图像的从零开始的索引。此索引标识要用作覆盖掩码的图像。

[in] iOverlay

类型： int

int 类型的值，包含覆盖掩码的从 1 开始的索引。

类型： HRESULT

如果该方法成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

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

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

若要使用 IImageList：：SetOverlayImage，请在清单中指定 Comctl32.dll 版本 6。有关清单的详细信息，请参阅启用视觉样式。