ImageList_AddMasked (commctrl.h)

Menambahkan gambar atau gambar ke daftar gambar, menghasilkan masker dari bitmap yang ditentukan.

Sintaks

int ImageList_AddMasked(
  HIMAGELIST himl,
  HBITMAP    hbmImage,
  COLORREF   crMask
);

Parameter

himl

Jenis: HIMAGELIST

Handel ke daftar gambar.

hbmImage

Jenis: HBITMAP

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

crMask

Jenis: COLORREF

Warna yang digunakan untuk menghasilkan masker. Setiap piksel warna ini dalam bitmap yang ditentukan diubah menjadi hitam, dan bit yang sesuai dalam masker diatur ke 1. Jika parameter ini CLR_DEFAULT, maka warna piksel pada (0,0) digunakan sebagai masker.

Mengembalikan nilai

Jenis: int

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

Keterangan

Fungsi ImageList_AddMasked menyalin bitmap ke struktur data internal. Bitmap dengan kedalaman warna yang lebih besar dari 8bpp tidak didukung. Pastikan untuk menggunakan fungsi DeleteObject untuk menghapus hbmImage setelah fungsi kembali.

Persyaratan

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
Set API	ext-ms-win-shell-comctl32-init-l1-1-1 (diperkenalkan dalam Windows 10, versi 10.0.14393)