LVM_GETNEXTITEMINDEX pesan

Mengambil indeks item dalam kontrol tampilan daftar tertentu yang cocok dengan properti dan hubungan yang ditentukan dengan item lain. Kirim pesan ini secara eksplisit atau dengan menggunakan makro ListView_GetNextItemIndex .

Parameter

wParam [masuk, keluar]

Penunjuk ke struktur LVITEMINDEX agar item memulai pencarian dengan, atau -1 untuk menemukan item pertama yang cocok dengan bendera yang ditentukan. Proses panggilan bertanggung jawab untuk mengalokasikan struktur ini dan menetapkan anggotanya.

lParam

Menentukan hubungan dengan item yang tercantum dalam parameter wParam. Ini bisa berupa salah satu atau kombinasi dari nilai berikut:

Nilai Makna
Mencari berdasarkan indeks.
LVNI_ALL
Mencari item berikutnya menurut indeks, nilai default.
Mencari berdasarkan hubungan fisik dengan 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_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.
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, pencarian berlanjut dengan item berikutnya.

Nilai kembali

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya.

Keterangan

Perhatikan bahwa bendera berikut, untuk digunakan hanya dengan Windows Vista, sama-sama tidak termasuk bendera lain yang digunakan: LVNI_PREVIOUS, 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 2008 [hanya aplikasi desktop]
Header
Commctrl.h

Lihat juga

LVM_GETNEXTITEM