Metode IImageList::ReplaceIcon (commoncontrols.h)

Artikel
02/26/2024

Mengganti gambar dengan ikon atau kursor.

Sintaks

HRESULT ReplaceIcon(
  [in]  int   i,
  [in]  HICON hicon,
  [out] int   *pi
);

Parameter

[in] i

Jenis: int

Nilai tipe int yang berisi indeks gambar untuk diganti. Jika i -1, fungsi menambahkan gambar ke akhir daftar.

[in] hicon

Jenis: HICON

Handel ke ikon atau kursor yang berisi bitmap dan mask untuk gambar baru.

[out] pi

Jenis: int*

Penunjuk ke int yang akan berisi indeks gambar yang dikembalikan jika berhasil, atau -1 sebaliknya.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Karena sistem tidak menyimpan hicon, Anda dapat menghancurkannya setelah fungsi kembali jika ikon atau kursor dibuat oleh CreateIcon. Anda tidak perlu menghancurkan hicon jika dimuat oleh fungsi LoadIcon ; sistem secara otomatis membebaskan sumber daya ikon ketika tidak lagi diperlukan.

Untuk menggunakan IImageList::ReplaceIcon, 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 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	commoncontrols.h
DLL	Comctl32.dll (versi 6.0 atau yang lebih baru)

Bagikan melalui