Share via

IImageList2：：Replace2 方法 (commoncontrols.h)

  • 项目

替换图像列表中的图像。

语法

HRESULT Replace2(
  [in]           int      i,
  [in]           HBITMAP  hbmImage,
  [in, optional] HBITMAP  hbmMask,
  [in, optional] IUnknown *punk,
  [in]           DWORD    dwFlags
);

参数

[in] i

类型： int

要替换的图像的索引。

[in] hbmImage

类型： HBITMAP

包含图像的位图的句柄。

[in, optional] hbmMask

类型： HBITMAP

包含掩码的位图的句柄。 如果未将蒙板用于图像列表，则忽略此参数。

[in, optional] punk

类型： IUnknown*

指向 IUnknown 接口的 指针。

[in] dwFlags

类型： DWORD

指定如何将掩码作为以下修饰标志的一个或按位组合应用于图像。

值 含义
ILR_DEFAULT
0x0000
 未使用。
ILR_HORIZONTAL_LEFT
0x0000
 水平左对齐。
ILR_HORIZONTAL_CENTER
0x0001
 水平居中。
ILR_HORIZONTAL_RIGHT
0x0002
 向右水平对齐。
ILR_VERTICAL_TOP
0x0000
 垂直与顶部对齐。
ILR_VERTICAL_CENTER
0x0010
 垂直对齐居中。
ILR_VERTICAL_BOTTOM
0x0020
 垂直与底部对齐。
ILR_SCALE_CLIP
0x0000
 不执行任何操作。
ILR_SCALE_ASPECTRATIO
0x0100
 调整。

返回值

类型： HRESULT

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

要求

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