iImageList::Merge 方法 (commoncontrols.h)

通过组合两个现有映像创建新映像。 此方法还会创建一个新的图像列表,用于存储图像。

语法

HRESULT Merge(
  [in]  int      i1,
  [in]  IUnknown *punk2,
  [in]  int      i2,
  [in]  int      dx,
  [in]  int      dy,
  [out] REFIID   riid,
  [out] void     **ppv
);

参数

[in] i1

类型: int

一个 int 类型的值,该值包含第一个现有图像的索引。

[in] punk2

类型: IUnknown*

指向包含第二个图像的图像列表的 IUnknown 接口的指针。

[in] i2

类型: int

一个 int 类型的值,该值包含第二个现有图像的索引。

[in] dx

类型: int

一个 int 类型的值,该值包含第二个图像相对于第一个图像的偏移量的 x 分量。

[in] dy

类型: int

int 类型的值,该值包含第二个图像相对于第一个图像的偏移量的 y 分量。

[out] riid

类型: REFIID

新映像列表的接口的 IID。

[out] ppv

类型: PVOID*

指向新图像列表接口的原始指针。

返回值

类型: HRESULT

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

注解

新图像由在第一个图像上透明绘制的第二个图像组成。 通过将两个现有图像的掩码与按位 OR 运算符相结合来获取新图像的掩码。

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

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 commoncontrols.h
DLL Comctl32.dll (6.0 或更高版本)