ListView_GetNextItemIndex makro (commctrl.h)

2024-10-24

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

Sintaksis

BOOL ListView_GetNextItemIndex(
  [in]      HWND        hwnd,
  [in, out] LVITEMINDEX *plvii,
            LPARAM      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 menetapkan anggotanya.

flags

Jenis: LPARAM

Hubungan dengan item yang ditentukan dalam parameter plvii. Ini bisa berupa satu atau kombinasi dari nilai berikut:

Nilai	Arti
Mencari menurut 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 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 set bendera status LVIS_CUT.
LVNI_DROPHILITED	Item memiliki set bendera status LVIS_DROPHILITED
LVNI_FOCUSED	Item memiliki set bendera status LVIS_FOCUSED.
LVNI_SELECTED	Item memiliki set bendera status LVIS_SELECTED.
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 akan dilanjutkan dengan item berikutnya.

Mengembalikan nilai

Jenis: BOOL

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya.

Komentar

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

Syarat	Nilai
klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Platform Target	Windows
Header	commctrl.h

Lihat juga

LVM_GETNEXTITEM

Bagikan melalui