Metode IImageList::SetOverlayImage (commoncontrols.h)

Artikel
02/26/2024

Menambahkan gambar tertentu ke daftar gambar yang digunakan sebagai masker overlay. Daftar gambar dapat memiliki hingga empat masker overlay di Common Controls versi 4.70 dan yang lebih lama, dan hingga 15 di versi 4.71 atau yang lebih baru. Metode ini menetapkan indeks masker overlay ke gambar yang ditentukan.

Sintaks

HRESULT SetOverlayImage(
  [in] int iImage,
  [in] int iOverlay
);

Parameter

[in] iImage

Jenis: int

Nilai tipe int yang berisi indeks berbasis nol dari gambar dalam daftar gambar. Indeks ini mengidentifikasi gambar yang akan digunakan sebagai masker overlay.

[in] iOverlay

Jenis: int

Nilai jenis int yang berisi indeks berbasis satu dari masker overlay.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Masker overlay adalah gambar yang digambar secara transparan di atas gambar lain. Untuk menggambar masker overlay di atas gambar, panggil IImageList::D raw. Parameter fStyle dari fungsi-fungsi ini dapat menggunakan makro INDEXTOOVERLAYMASK untuk menentukan indeks masker overlay.

Panggilan ke metode ini gagal dan mengembalikan E_INVALIDARG kecuali daftar gambar dibuat menggunakan masker.

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