ImageList_AddIcon makro (commctrl.h)

Menambahkan ikon atau kursor ke daftar gambar. ImageList_AddIcon memanggil fungsi ImageList_ReplaceIcon .

Sintaks

int ImageList_AddIcon(
   HIMAGELIST himl,
   HICON      hicon
);

Parameter

himl

Jenis: HIMAGELIST

Handel ke daftar gambar. Jika parameter ini mengidentifikasi daftar gambar bertopeng, makro menyalin bitmap gambar dan mask dari ikon atau kursor. Jika parameter ini mengidentifikasi daftar gambar yang tidak dimasak, makro hanya menyalin bitmap gambar.

hicon

Jenis: HICON

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

Mengembalikan nilai

Jenis: int

Mengembalikan indeks gambar jika berhasil, atau -1 sebaliknya.

Keterangan

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

Makro ImageList_AddIcon didefinisikan sebagai berikut:

#define  ImageList_AddIcon(himl, hicon) ImageList_ReplaceIcon(himl, -1, hicon)

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	commctrl.h