ImageList_Add (commctrl.h)

Menambahkan gambar atau gambar ke daftar gambar.

Sintaks

int ImageList_Add(
  [in]           HIMAGELIST himl,
  [in]           HBITMAP    hbmImage,
  [in, optional] HBITMAP    hbmMask
);

Parameter

[in] himl

Jenis: HIMAGELIST

Handel ke daftar gambar.

[in] hbmImage

Jenis: HBITMAP

Handel ke bitmap yang berisi gambar atau gambar. Jumlah gambar disimpulkan dari lebar bitmap.

[in, optional] hbmMask

Jenis: HBITMAP

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

Mengembalikan nilai

Jenis: int

Mengembalikan indeks gambar baru pertama jika berhasil, atau -1 jika tidak.

Keterangan

Fungsi ImageList_Add menyalin bitmap ke struktur data internal. Pastikan untuk menggunakan fungsi DeleteObject untuk menghapus hbmImage dan hbmMask setelah fungsi kembali.

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
Pustaka	Comctl32.lib
DLL	Comctl32.dll