ImageList_DrawEx (commctrl.h)

Menggambar item daftar gambar dalam konteks perangkat yang ditentukan. Fungsi ini menggunakan gaya gambar yang ditentukan dan memadukan gambar dengan warna yang ditentukan.

Sintaks

BOOL ImageList_DrawEx(
  HIMAGELIST himl,
  int        i,
  HDC        hdcDst,
  int        x,
  int        y,
  int        dx,
  int        dy,
  COLORREF   rgbBk,
  COLORREF   rgbFg,
  UINT       fStyle
);

Parameter

himl

Jenis: HIMAGELIST

Handel ke daftar gambar

i

Jenis: int

Indeks gambar yang akan 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.

dx

Jenis: int

Lebar bagian gambar untuk menggambar relatif terhadap sudut kiri atas gambar. Jika dx dan dy adalah nol, fungsi akan menggambar seluruh gambar. Fungsi ini tidak memastikan bahwa parameter valid.

dy

Jenis: int

Tinggi bagian gambar untuk digambar, relatif terhadap sudut kiri atas gambar. Jika dx dan dy adalah nol, fungsi akan menggambar seluruh gambar. Fungsi ini tidak memastikan bahwa parameter valid.

rgbBk

Jenis: COLORREF

Warna latar belakang gambar. Parameter ini dapat menjadi nilai RGB yang ditentukan aplikasi atau salah satu nilai berikut:

Nilai	Makna
CLR_NONE	Tidak ada warna latar belakang. Gambar digambar secara transparan.
CLR_DEFAULT	Warna latar belakang default. Gambar digambar menggunakan warna latar belakang daftar gambar.

rgbFg

Jenis: COLORREF

Warna latar depan gambar. Parameter ini dapat menjadi nilai RGB yang ditentukan aplikasi atau salah satu nilai berikut:

Nilai	Makna
CLR_NONE	Tidak ada warna campuran. Gambar dipadukan dengan warna konteks perangkat tujuan.
CLR_DEFAULT	Warna latar depan default. Gambar digambar menggunakan warna sorotan sistem sebagai warna latar depan.

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 campuran yang ditentukan oleh rgbFg. Nilai ini tidak berpengaruh jika daftar gambar tidak berisi masker.
ILD_BLEND50	Gambar gambar, memadukan 50 persen dengan warna campuran yang ditentukan oleh rgbFg. 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	Gambar 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.

Nilai kembali

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 hasil 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