LVM_GETNEXTITEM pesan

  • Artikel

Mencari item tampilan daftar yang memiliki properti yang ditentukan dan menanggung hubungan yang ditentukan ke item tertentu. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro ListView_GetNextItem .

Parameter

wParam

Indeks item untuk memulai pencarian dengan, atau -1 untuk menemukan item pertama yang cocok dengan bendera yang ditentukan. Item yang ditentukan itu sendiri dikecualikan dari pencarian.

lParam

Menentukan hubungan dengan item yang ditentukan dalam wParam. Ini bisa menjadi salah satu atau kombinasi dari nilai berikut:

Nilai Makna
Mencari berdasarkan indeks.
LVNI_ALL
 Mencari item berikutnya menurut indeks, nilai default.
LVNI_PREVIOUS
 Windows Vista dan yang lebih baru: Mencari item yang diurutkan sebelum item yang ditentukan dalam wParam. Bendera LVNI_PREVIOUS tidak terarah (LVNI_ABOVE akan menemukan item yang diposisikan di atas, sementara LVNI_PREVIOUS akan menemukan item yang diurutkan sebelumnya.) Bendera LVNI_PREVIOUS pada dasarnya membalikkan logika pencarian yang dilakukan oleh pesan LVM_GETNEXTITEM atau LVM_GETNEXTITEMINDEX .
Mencari berdasarkan hubungan fisik ke indeks item tempat pencarian akan dimulai.
LVNI_ABOVE
 Mencari item yang berada di atas item yang ditentukan.
LVNI_BELOW
 Mencari item yang berada di bawah item yang ditentukan.
LVNI_TOLEFT
 Mencari item di sebelah kiri item yang ditentukan.
LVNI_TORIGHT
 Mencari item di sebelah kanan item yang ditentukan.
LVNI_DIRECTIONMASK
 Windows Vista dan yang lebih baru: Masker bendera arah dengan nilai sebagai berikut: LVNI_ABOVE | LVNI_BELOW | LVNI_TOLEFT | LVNI_TORIGHT.
Status item yang akan ditemukan dapat ditentukan dengan satu atau kombinasi nilai berikut:
LVNI_CUT
 Item memiliki bendera status LVIS_CUT diatur.
LVNI_DROPHILITED
 Item memiliki bendera status LVIS_DROPHILITED diatur
LVNI_FOCUSED
 Item memiliki bendera status LVIS_FOCUSED diatur.
LVNI_SELECTED
 Item memiliki bendera status LVIS_SELECTED diatur.
LVNI_STATEMASK
 Windows Vista dan yang lebih baru: Masker bendera status dengan nilai sebagai berikut: LVNI_FOCUSED | LVNI_SELECTED | LVNI_CUT | LVNI_DROPHILITED.
Mencari berdasarkan tampilan item atau menurut grup
LVNI_VISIBLEORDER
 Windows Vista dan yang lebih baru: Cari urutan yang terlihat.
LVNI_VISIBLEONLY
 Windows Vista dan yang lebih baru: Cari item yang terlihat.
LVNI_SAMEGROUPONLY
 Windows Vista dan yang lebih baru: Cari grup saat ini.
Jika item tidak memiliki semua bendera status yang ditentukan yang ditetapkan, pencarian berlanjut dengan item berikutnya.

Nilai kembali

Mengembalikan indeks item berikutnya jika berhasil, atau -1 jika tidak.

Keterangan

Perhatikan bahwa bendera berikut, untuk digunakan hanya dengan Windows Vista, saling eksklusif dari bendera lain yang digunakan: LVNI_VISIBLEONLY, LVNI_SAMEGROUPONLY, LVNI_VISIBLEORDER, LVNI_DIRECTIONMASK, dan LVNI_STATEMASK.

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