ListView_GetNextItemIndex makro (commctrl.h)

  • Artikel

Mendapatkan indeks item dalam kontrol tampilan daftar tertentu yang memiliki properti dan hubungan yang ditentukan dengan item tertentu lainnya. Gunakan makro ini atau kirim pesan LVM_GETNEXTITEMINDEX secara eksplisit.

Sintaks

void ListView_GetNextItemIndex(
  [in]       hwnd,
  [in, out]  plvii,
             flags
);

Parameter

[in] hwnd

Jenis: HWND

Handel ke kontrol tampilan daftar.

[in, out] plvii

Jenis: LVITEMINDEX*

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

flags

Jenis: LPARAM

Hubungan dengan item yang ditentukan dalam parameter plvii. Ini bisa menjadi 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 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_PREVIOUS
 Windows Vista dan yang lebih baru: Mencari item yang sebelumnya ke item yang ditentukan. 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 melalui 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 yang ditetapkan, pencarian berlanjut dengan item berikutnya.

Mengembalikan nilai

Tidak ada

Keterangan

Perhatikan bahwa bendera berikut, untuk digunakan hanya dengan Windows Vista, saling eksklusif dari 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]
Target Platform Windows
Header commctrl.h

Lihat juga

LVM_GETNEXTITEM