ListView_SetItemState makro (commctrl.h)

2024-10-24

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

Sintaksis

void ListView_SetItemState(
   HWND hwndLV,
   int  i,
   UINT data,
   UINT 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 data yang valid. Makro mengabaikan bit dalam parameter data 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	Arti
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 dipilih jika kontrol tampilan daftar memiliki fokus atau gaya LVS_SHOWSELALWAYS digunakan.

mask

Jenis: UINT

Bit parameter data 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.

Mengembalikan nilai

Tidak

Komentar

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 data menentukan nilai baru untuk bit tersebut. Untuk mengatur sedikit dalam status internal item, atur di parameter dan data. Untuk menghapus sedikit dalam status internal item, atur dalam parameter mask dan bersihkan dalam parameter data . Untuk membiarkan sedikit tidak berubah dalam status internal item, kosongkan di parameter mask .

Bit 8 hingga 11 dari parameter data menentukan indeks berbasis satu 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 dari parameter data menentukan indeks berbasis satu gambar 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

Syarat	Nilai
klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	commctrl.h

Lihat juga

ListView_GetItemState

Bagikan melalui