ImageList_SetOverlayImage (commctrl.h)

Artikel
02/24/2024

Menambahkan gambar tertentu ke daftar gambar yang akan digunakan sebagai masker overlay. Daftar gambar dapat memiliki hingga empat masker overlay dalam versi 4.70 dan yang lebih lama dan hingga 15 dalam versi 4.71. Fungsi menetapkan indeks masker overlay ke gambar yang ditentukan.

Sintaks

BOOL ImageList_SetOverlayImage(
  [in] HIMAGELIST himl,
  [in] int        iImage,
  [in] int        iOverlay
);

Parameter

[in] himl

Jenis: HIMAGELIST

Handel ke daftar gambar.

[in] iImage

Jenis: int

Indeks gambar berbasis nol dalam daftar gambar himl . Indeks ini mengidentifikasi gambar yang akan digunakan sebagai masker overlay.

[in] iOverlay

Jenis: int

Indeks berbasis satu masker overlay.

Mengembalikan nilai

Jenis: BOOL

Mengembalikan bukan nol jika berhasil, atau nol sebaliknya.

Keterangan

Topeng overlay adalah gambar yang digambar secara transparan di atas gambar lain. Untuk menggambar masker overlay di atas gambar, panggil fungsi ImageList_Draw atau ImageList_DrawEx . 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.

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

Bagikan melalui