Struktur NMLVCUSTOMDRAW (commctrl.h)

  • Artikel

Berisi informasi khusus untuk kode pemberitahuan NM_CUSTOMDRAW (tampilan daftar) yang dikirim oleh kontrol tampilan daftar.

Sintaks

typedef struct tagNMLVCUSTOMDRAW {
  NMCUSTOMDRAW nmcd;
  COLORREF     clrText;
  COLORREF     clrTextBk;
  int          iSubItem;
  DWORD        dwItemType;
  COLORREF     clrFace;
  int          iIconEffect;
  int          iIconPhase;
  int          iPartId;
  int          iStateId;
  RECT         rcText;
  UINT         uAlign;
} NMLVCUSTOMDRAW, *LPNMLVCUSTOMDRAW;

Anggota

nmcd

Jenis: NMCUSTOMDRAW

Struktur NMCUSTOMDRAW yang berisi informasi gambar kustom umum.

clrText

Jenis: COLORREF

Nilai COLORREF yang mewakili warna yang akan digunakan untuk menampilkan latar depan teks dalam kontrol tampilan daftar.

clrTextBk

Jenis: COLORREF

Nilai COLORREF yang mewakili warna yang akan digunakan untuk menampilkan latar belakang teks dalam kontrol tampilan daftar. Di Versi 6.0., anggota ini diabaikan jika gambar latar belakang diatur dengan pesan LVM_SETBKIMAGE .

iSubItem

Jenis: int

Versi 4.71. Indeks subitem yang sedang digambar. Jika item utama sedang digambar, anggota ini akan menjadi nol.

dwItemType

Jenis: DWORD

Versi 6.0.   DWORD yang berisi tipe item yang akan digambar. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai Makna
LVCDI_ITEM
 Item akan digambar.
LVCDI_GROUP
 Sebuah kelompok akan digambar.
LVCDI_ITEMSLIST
 Setiap item akan digambar.

clrFace

Jenis: COLORREF

Versi 6.0.Nilai COLORREF mewakili warna yang akan digunakan untuk menampilkan wajah item.

iIconEffect

Jenis: int

Versi 6.0.  Nilai tipe int yang menentukan efek yang diterapkan ke ikon, seperti Cahaya, Bayangan, atau Pulse.

iIconPhase

Jenis: int

Versi 6.0.  Nilai tipe int yang menentukan fase ikon.

iPartId

Jenis: int

Versi 6.0.  Nilai tipe int yang menentukan ID dari bagian item yang akan digambar.

iStateId

Jenis: int

Versi 6.0.  Nilai tipe int yang menentukan ID status item yang akan digambar.

rcText

Jenis: RECT

Versi 6.0.RECT yang menentukan persegi panjang di mana teks akan digambar.

uAlign

Jenis: UINT

Versi 6.0.UINT yang menentukan bagaimana grup harus diratakan. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai Makna
LVGA_HEADER_CENTER
 Tengahkan grup.
LVGA_HEADER_LEFT
 Sejajarkan grup di sebelah kiri.
LVGA_HEADER_RIGHT
 Ratakan grup di sebelah kanan.

Keterangan

Perhatikan Comctl32.dll versi 6 tidak dapat didistribusikan ulang tetapi disertakan dalam Windows atau yang lebih baru. Untuk menggunakan Comctl32.dll versi 6, tentukan dalam manifes. Untuk informasi selengkapnya tentang manifes, lihat Mengaktifkan Gaya Visual.
 

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Header commctrl.h