ListView_SetItemState makro (commctrl.h)

  • Artikel

Mengubah status item dalam kontrol tampilan daftar. Anda dapat menggunakan makro ini atau mengirim pesan LVM_SETITEMSTATE secara eksplisit.

Sintaks

void ListView_SetItemState(
   hwndLV,
   i,
   data,
   mask
);

Parameter

hwndLV

Jenis: HWND

Handel ke kontrol tampilan daftar.

i

Jenis: int

Indeks item tampilan daftar. Jika parameter ini adalah -1, maka perubahan status diterapkan ke semua item.

data

Jenis: UINT

Bit status baru untuk item. Parameter mask menunjukkan bit parameter status yang valid. Makro mengabaikan bit dalam parameter status jika bit yang sesuai tidak diatur dalam parameter mask. Byte berurutan rendah berisi sekumpulan bendera bit yang menunjukkan status item. Byte ini bisa menjadi kombinasi dari nilai berikut:

Nilai Makna
LVIS_CUT
 Item ditandai untuk operasi potong dan tempel.
LVIS_DROPHILITED
 Item disorot sebagai target seret dan letakkan.
LVIS_FOCUSED
 Item memiliki fokus, sehingga dikelilingi oleh persegi panjang fokus standar. Meskipun lebih dari satu item dapat dipilih, hanya satu item yang dapat memiliki fokus.
LVIS_SELECTED
 Item dipilih. Tampilan item yang dipilih tergantung pada apakah item tersebut memiliki fokus dan juga pada warna sistem yang digunakan untuk pemilihan. Item hanya akan ditampilkan sebagai terpilih jika kontrol tampilan daftar memiliki fokus atau gaya LVS_SHOWSELALWAYS digunakan.

mask

Jenis: UINT

Bit parameter status yang ingin Anda atur atau hapus. Anda dapat menggunakan ListView_SetItemState untuk mengatur dan menghapus bit. Untuk mengatur indeks gambar overlay item, atur bit LVIS_OVERLAYMASK . Untuk mengatur indeks gambar status item, atur bit LVIS_STATEIMAGEMASK .

Nilai kembali

Tidak ada

Keterangan

Nilai status item menyertakan sekumpulan bendera bit yang menunjukkan status item. Nilai status juga dapat menyertakan indeks daftar gambar yang menunjukkan gambar status item dan gambar overlay.

Parameter mask menentukan bit status yang ingin Anda ubah, dan parameter status menentukan nilai baru untuk bit tersebut. Untuk mengatur sedikit dalam status internal item, atur dalam parameter masker dan status . Untuk menghapus sedikit dalam status internal item, atur dalam parameter masker dan bersihkan dalam parameter status . Untuk membiarkan sedikit tidak berubah dalam status internal item, kosongkan dalam parameter masker .

Bit 8 hingga 11 parameter status menentukan indeks berbasis satu dari gambar overlay dalam daftar gambar kontrol. Daftar gambar ikon berukuran penuh dan daftar gambar ikon kecil dapat memiliki gambar overlay. Gambar overlay ditumpakan di atas gambar ikon item. Jika bit ini nol, item tidak memiliki gambar overlay. Untuk mengisolasi bit ini, gunakan masker LVIS_OVERLAYMASK . Untuk menentukan indeks overlay, gunakan makro INDEXTOOVERLAYMASK .

Bit 12 hingga 15 parameter status menentukan indeks gambar berbasis satu dalam daftar gambar status kontrol. Gambar status ditampilkan di samping ikon item untuk menunjukkan status yang ditentukan aplikasi. Jika bit ini nol, item tidak memiliki gambar status. Untuk mengisolasi bit ini, gunakan masker LVIS_STATEIMAGEMASK . Untuk menentukan indeks gambar status, gunakan makro INDEXTOSTATEIMAGEMASK .

Persyaratan

Persyaratan Nilai
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

Lihat juga

ListView_GetItemState