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 |
---|---|
|
Tidak ada warna latar belakang. Gambar digambar secara transparan. |
|
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:
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 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 |