IImageList::Tambahkan metode (commoncontrols.h)

Menambahkan gambar atau gambar ke daftar gambar.

Sintaks

HRESULT Add(
  [in]           HBITMAP hbmImage,
  [in, optional] HBITMAP hbmMask,
  [out]          int     *pi
);

Parameter

[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.

[out] pi

Jenis: int*

Ketika metode ini kembali, berisi penunjuk ke indeks gambar baru pertama. Jika metode gagal menambahkan gambar baru, nilai ini adalah -1.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

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

Untuk menggunakan IImageList::Add, 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)