ImageList_Draw (commctrl.h)

Menggambar item daftar gambar dalam konteks perangkat yang ditentukan.

Sintaks

BOOL ImageList_Draw(
  HIMAGELIST himl,
  int        i,
  HDC        hdcDst,
  int        x,
  int        y,
  UINT       fStyle
);

Parameter

himl

Jenis: HIMAGELIST

Handel ke daftar gambar.

i

Jenis: int

Indeks gambar berbasis nol untuk digambar.

hdcDst

Jenis: HDC

Handel ke konteks perangkat tujuan.

x

Jenis: int

Koordinat x untuk menggambar dalam konteks perangkat yang ditentukan.

y

Jenis: int

Koordinat y untuk menggambar dalam konteks perangkat yang ditentukan.

fStyle

Jenis: UINT

Gaya menggambar dan, secara opsional, gambar overlay. Untuk informasi tentang menentukan indeks gambar overlay, lihat bagian komentar di akhir topik ini. Parameter ini dapat berupa kombinasi indeks gambar overlay dan satu atau beberapa nilai berikut:

Nilai	Makna
ILD_BLEND
ILD_BLEND25	Menggambar gambar, memadukan 25 persen dengan warna sorotan sistem. Nilai ini tidak berpengaruh jika daftar gambar tidak berisi masker.
ILD_BLEND50	Menggambar gambar, memadukan 50 persen dengan warna sorotan sistem. Nilai ini tidak berpengaruh jika daftar gambar tidak berisi masker.
ILD_FOCUS
ILD_IMAGE	Atur bendera ini jika overlay tidak memerlukan masker untuk digambar. Bendera ini menyebabkan ImageList_DrawEx hanya menggambar gambar, mengabaikan masker.
ILD_MASK	Menggambar topeng.
ILD_NORMAL	Menggambar gambar menggunakan warna latar belakang untuk daftar gambar. Jika warna latar belakang adalah nilai CLR_NONE, gambar digambar secara transparan menggunakan masker.
ILD_SELECTED
ILD_TRANSPARENT	Menggambar gambar secara transparan menggunakan masker, terlepas dari warna latar belakangnya. Nilai ini tidak berpengaruh jika daftar gambar tidak berisi masker.

Mengembalikan nilai

Jenis: BOOL

Mengembalikan bukan nol jika berhasil, atau nol sebaliknya.

Keterangan

Gambar overlay digambar secara transparan di atas gambar utama yang ditentukan dalam parameter i . Untuk menentukan gambar overlay dalam parameter fStyle , gunakan makro INDEXTOOVERLAYMASK untuk menggeser indeks berbasis satu gambar overlay. Gunakan operator OR untuk menggabungkan nilai pengembalian makro secara logis dengan bendera gaya gambar yang ditentukan dalam parameter fStyle . Anda harus terlebih dahulu menentukan gambar ini sebagai gambar overlay dengan menggunakan fungsi ImageList_SetOverlayImage .

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)