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 或更高版本) |