共用方式為


IImageList::Replace 方法 (commoncontrols.h)

以新的影像取代影像清單中的影像。

語法

HRESULT Replace(
  [in]           int     i,
  [in]           HBITMAP hbmImage,
  [in, optional] HBITMAP hbmMask
);

參數

[in] i

類型: int

int 類型的值,其中包含要取代之影像的索引。

[in] hbmImage

類型: HBITMAP

包含影像之點陣圖的句柄。

[in, optional] hbmMask

類型: HBITMAP

包含遮罩之位圖的句柄。 如果未搭配影像清單使用遮罩,則會忽略此參數。

傳回值

類型: HRESULT

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

IImageList::Replace 會將點圖複製到內部數據結構。 您必須在方法傳回之後,使用 DeleteObject 來刪除 hbmImagehbmMask

若要使用 IImageList::Replace,請在指令清單中指定第 6 版 Comctl32.dll。 如需指令清單的詳細資訊,請參閱 啟用可視化樣式

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 commoncontrols.h
Dll Comctl32.dll (6.0 版或更新版本)