Bagikan melalui

Struktur IMAGELISTDRAWPARAMS (commctrl.h)

  • Artikel

Berisi informasi tentang operasi gambar daftar gambar dan digunakan dengan fungsi IImageList::D raw .

Sintaks

typedef struct _IMAGELISTDRAWPARAMS {
  DWORD      cbSize;
  HIMAGELIST himl;
  int        i;
  HDC        hdcDst;
  int        x;
  int        y;
  int        cx;
  int        cy;
  int        xBitmap;
  int        yBitmap;
  COLORREF   rgbBk;
  COLORREF   rgbFg;
  UINT       fStyle;
  DWORD      dwRop;
  DWORD      fState;
  DWORD      Frame;
  COLORREF   crEffect;
} IMAGELISTDRAWPARAMS, *LPIMAGELISTDRAWPARAMS;

Anggota

cbSize

Jenis: DWORD

Ukuran struktur ini, dalam byte.

himl

Jenis: HIMAGELIST

Handel ke daftar gambar yang berisi gambar yang akan digambar.

i

Jenis: int

Indeks gambar berbasis nol yang akan digambar.

hdcDst

Jenis: HDC

Handel ke konteks perangkat tujuan.

x

Jenis: int

Koordinat x yang menentukan di mana gambar digambar.

y

Jenis: int

Koordinat y yang menentukan di mana gambar digambar.

cx

Jenis: int

Nilai yang menentukan jumlah piksel yang akan digambar, relatif terhadap sudut kiri atas operasi menggambar seperti yang ditentukan oleh xBitmap dan yBitmap. Jika cx dan cy adalah nol, maka Gambar akan menggambar seluruh bagian yang valid. Metode ini tidak memastikan bahwa parameter valid.

cy

Jenis: int

Nilai yang menentukan jumlah piksel yang akan digambar, relatif terhadap sudut kiri atas operasi menggambar seperti yang ditentukan oleh xBitmap dan yBitmap. Jika cx dan cy adalah nol, maka Gambar akan menggambar seluruh bagian yang valid. Metode ini tidak memastikan bahwa parameter valid.

xBitmap

Jenis: int

Koordinat x yang menentukan sudut kiri atas operasi menggambar mengacu pada gambar itu sendiri. Piksel gambar yang berada di sebelah kiri xBitmap dan di atas yBitmap tidak muncul.

yBitmap

Jenis: int

Koordinat y yang menentukan sudut kiri atas operasi menggambar mengacu pada gambar itu sendiri. Piksel gambar yang berada di sebelah kiri xBitmap dan di atas yBitmap tidak muncul.

rgbBk

Jenis: COLORREF

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

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

rgbFg

Jenis: COLORREF

Warna latar depan gambar. Anggota ini hanya digunakan jika fStyle menyertakan bendera ILD_BLEND25 atau ILD_BLEND50 . Parameter ini dapat menjadi nilai RGB yang ditentukan aplikasi atau salah satu nilai berikut:

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

fStyle

Jenis: UINT

Bendera yang menentukan gaya menggambar dan, secara opsional, gambar overlay. Lihat bagian komentar di akhir topik ini untuk informasi tentang gambar overlay. Anggota ini dapat berisi satu atau beberapa bendera gambar daftar gambar.

dwRop

Jenis: DWORD

Nilai yang menentukan kode operasi raster. Kode-kode ini menentukan bagaimana data warna untuk persegi panjang sumber akan dikombinasikan dengan data warna untuk persegi panjang tujuan untuk mencapai warna akhir. Anggota ini diabaikan jika fStyle tidak menyertakan bendera ILD_ROP . Beberapa kode operasi raster umum meliputi:

Nilai Makna
KEGELAPAN
 Mengisi persegi panjang tujuan menggunakan warna yang terkait dengan indeks nol di palet fisik. (Warna ini hitam untuk palet fisik default.)
DSTINVERT
 Menginversi persegi panjang tujuan.
MERGECOPY
 Menggabungkan warna persegi panjang sumber dengan pola yang ditentukan dengan menggunakan operator BOolean AND .
MERGEPAINT
 Menggabungkan warna persegi panjang sumber terbalik dengan warna persegi panjang tujuan dengan menggunakan operator OR Boolean.
NOTSRCCOPY
 Menyalin persegi panjang sumber terbalik ke tujuan.
NOTSRCERASE
 Menggabungkan warna persegi panjang sumber dan tujuan dengan menggunakan operator OR Boolean. Menginversi warna yang dihasilkan.
PATCOPY
 Menyalin pola yang ditentukan ke dalam bitmap tujuan.
PATINVERT
 Menggabungkan warna pola yang ditentukan dengan warna persegi panjang tujuan dengan menggunakan operator Boolean XOR .
PATPAINT
 Menggabungkan warna pola dengan warna persegi panjang sumber terbalik dan menggabungkan hasilnya dengan warna persegi panjang tujuan dengan menggunakan operator BOolean OR .
SRCAND
 Menggabungkan warna persegi panjang sumber dan tujuan dengan menggunakan operator BOolean AND .
SRCCOPY
 Menyalin persegi panjang sumber langsung ke persegi panjang tujuan.
SRCERASE
 Menggabungkan warna terbalik persegi panjang tujuan dengan warna persegi panjang sumber dengan menggunakan operator BOolean AND .
SRCINVERT
 Menggabungkan warna persegi panjang sumber dan tujuan dengan menggunakan operator Boolean XOR .
SRCPAINT
 Menggabungkan warna persegi panjang sumber dan tujuan dengan menggunakan operator OR Boolean.
PUTIH
 Mengisi persegi panjang tujuan menggunakan warna yang terkait dengan indeks satu di palet fisik. Warna ini berwarna putih untuk palet fisik default.

fState

Jenis: DWORD

Bendera yang menentukan status gambar. Anggota ini dapat berisi satu atau beberapa bendera status daftar gambar. Anda harus menggunakan comctl32.dll versi 6 untuk menggunakan anggota ini. Lihat Komentar.

Frame

Jenis: DWORD

Digunakan dengan efek penpaduan alfa .

Saat digunakan dengan ILS_ALPHA, anggota ini memegang nilai untuk saluran alfa. Nilai ini bisa dari 0 hingga 255, dengan 0 benar-benar transparan, dan 255 benar-benar buram.

Anda harus menggunakan comctl32.dll versi 6 untuk menggunakan anggota ini. Lihat Komentar.

crEffect

Jenis: DWORD

Warna yang digunakan untuk efek cahaya dan bayangan . Anda harus menggunakan comctl32.dll versi 6 untuk menggunakan anggota ini. Lihat Komentar.

Keterangan

Gambar overlay adalah gambar yang digambar di atas gambar utama yang ditentukan dalam anggota i struktur ini. Untuk menentukan gambar overlay, gunakan operator bitwise OR untuk menggabungkan fStyle dengan makro INDEXTOOVERLAYMASK , melewati indeks berbasis satu gambar overlay dalam makro. Gambar ini sebelumnya harus ditentukan sebagai gambar overlay menggunakan API ImageList_SetOverlayImage .

Untuk mengekstrak gambar overlay dari fStyle, gunakan operator AND bitwise untuk menutupi fStyle dengan nilai ILD_OVERLAYMASK .

Comctl32.dll versi 6 tidak dapat didistribusikan ulang.. Untuk menggunakan Comctl32.dll versi 6, Anda harus menentukannya dalam manifes. Untuk informasi selengkapnya tentang manifes, lihat Mengaktifkan Gaya Visual.

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Header commctrl.h (sertakan Commctrl.h)