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 parameterdan 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.