Bagikan melalui


LVM_GETNEXTITEM pesan

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