IImageList::Ganti metode (commoncontrols.h)

Mengganti gambar dalam daftar gambar dengan gambar baru.

Sintaks

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

Parameter

[in] i

Jenis: int

Nilai tipe int yang berisi indeks gambar yang akan diganti.

[in] hbmImage

Jenis: HBITMAP

Handel ke bitmap yang berisi gambar.

[in, optional] hbmMask

Jenis: HBITMAP

Handel ke bitmap yang berisi masker. Jika tidak ada masker yang digunakan dengan daftar gambar, parameter ini diabaikan.

Mengembalikan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

IImageList::Replace menyalin bitmap ke struktur data internal. Anda harus menggunakan DeleteObject untuk menghapus hbmImage dan hbmMask setelah metode kembali.

Untuk menggunakan IImageList::Replace, tentukan Comctl32.dll versi 6 dalam manifes. Untuk informasi selengkapnya tentang manifes, lihat Mengaktifkan Gaya Visual.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	commoncontrols.h
DLL	Comctl32.dll (versi 6.0 atau yang lebih baru)