ListView_GetNextItemIndex makro (commctrl.h)
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 item berikutnya menurut indeks, nilai default. |
|
|
|
Mencari item yang berada di atas item yang ditentukan. |
|
Mencari item yang berada di bawah item yang ditentukan. |
|
Mencari item di sebelah kiri item yang ditentukan. |
|
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. |
|
Mencari item di sebelah kanan item yang ditentukan. |
|
Windows Vista dan yang lebih baru: Masker bendera arah dengan nilai sebagai berikut: LVNI_ABOVE | LVNI_BELOW | LVNI_TOLEFT | LVNI_TORIGHT. |
|
|
|
Item memiliki bendera status LVIS_CUT diatur. |
|
Item memiliki bendera status LVIS_DROPHILITED diatur |
|
Item memiliki bendera status LVIS_FOCUSED diatur. |
|
Item memiliki bendera status LVIS_SELECTED diatur. |
|
Windows Vista dan yang lebih baru: Masker bendera status dengan nilai sebagai berikut: LVNI_FOCUSED | LVNI_SELECTED | LVNI_CUT | LVNI_DROPHILITED. |
|
|
|
Windows Vista dan yang lebih baru: Cari urutan yang terlihat. |
|
Windows Vista dan yang lebih baru: Cari item yang terlihat. |
|
Windows Vista dan yang lebih baru: Cari grup saat ini. |
|
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 |