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 來刪除 hbmImage 和 hbmMask 。
若要使用 IImageList::Replace,請在指令清單中指定第 6 版 Comctl32.dll。 如需指令清單的詳細資訊,請參閱 啟用可視化樣式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | commoncontrols.h |
Dll | Comctl32.dll (6.0 版或更新版本) |