共用方式為

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