IImageList::AddMasked method (commoncontrols.h)

Artikel
02/26/2024

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

Sintaks

HRESULT AddMasked(
  [in]  HBITMAP  hbmImage,
  [in]  COLORREF crMask,
  [out] int      *pi
);

Parameter

[in] hbmImage

Jenis: HBITMAP

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

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

[out] pi

Jenis: int*

Pointer ke int yang berisi indeks gambar baru pertama saat kembali, 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

Catatan Bitmap yang diteruskan dalam hbmImage akan dimodifikasi.

IImageList::AddMasked menyalin bitmap ke struktur data internal. Bitmap dengan kedalaman warna yang lebih besar dari 8bpp tidak didukung. Anda harus menggunakan fungsi DeleteObject untuk menghapus hbmImage dan crMask setelah metode kembali.

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