pesan TVM_GETNEXTITEM

  • Artikel

Mengambil item tampilan pohon yang membawa hubungan yang ditentukan ke item tertentu. Anda dapat mengirim pesan ini secara eksplisit, dengan menggunakan makro TreeView_GetNextItem .

Parameter

wParam

Bendera yang menentukan item yang akan diambil. Parameter ini bisa menjadi salah satu nilai berikut:

Nilai Makna
TVGN_CARET
 Mengambil item terpilih saat ini. Anda bisa menggunakan makro TreeView_GetSelection untuk mengirim pesan ini.
TVGN_CHILD
 Mengambil item anak pertama dari item yang ditentukan oleh parameter hitem . Anda bisa menggunakan makro TreeView_GetChild untuk mengirim pesan ini.
TVGN_DROPHILITE
 Mengambil item yang menjadi target operasi seret dan letakkan. Anda bisa menggunakan makro TreeView_GetDropHilight untuk mengirim pesan ini.
TVGN_FIRSTVISIBLE
 Mengambil item pertama yang terlihat di jendela tampilan pohon. Anda bisa menggunakan makro TreeView_GetFirstVisible untuk mengirim pesan ini.
TVGN_LASTVISIBLE
 Versi 4.71. Mengambil item terakhir yang diperluas di pohon. Ini tidak mengambil item terakhir yang terlihat di jendela tampilan pohon. Anda bisa menggunakan makro TreeView_GetLastVisible untuk mengirim pesan ini.
TVGN_NEXT
 Mengambil item saudara berikutnya. Anda bisa menggunakan makro TreeView_GetNextSibling untuk mengirim pesan ini.
TVGN_NEXTSELECTED
 Windows Vista dan yang lebih baru. Mengambil item terpilih berikutnya. Anda bisa menggunakan makro TreeView_GetNextSelected untuk mengirim pesan ini.
TVGN_NEXTVISIBLE
 Mengambil item yang terlihat berikutnya yang mengikuti item yang ditentukan. Item yang ditentukan harus terlihat. Gunakan pesan TVM_GETITEMRECT untuk menentukan apakah item terlihat. Anda bisa menggunakan makro TreeView_GetNextVisible untuk mengirim pesan ini.
TVGN_PARENT
 Mengambil induk item yang ditentukan. Anda bisa menggunakan makro TreeView_GetParent untuk mengirim pesan ini.
TVGN_PREVIOUS
 Mengambil item saudara kandung sebelumnya. Anda bisa menggunakan makro TreeView_GetPrevSibling untuk mengirim pesan ini.
TVGN_PREVIOUSVISIBLE
 Mengambil item pertama yang terlihat yang mendahului item yang ditentukan. Item yang ditentukan harus terlihat. Gunakan pesan TVM_GETITEMRECT untuk menentukan apakah item terlihat. Anda bisa menggunakan makro TreeView_GetPrevVisible untuk mengirim pesan ini.
TVGN_ROOT
 Mengambil item paling atas atau sangat pertama dari kontrol tampilan pohon. Anda bisa menggunakan makro TreeView_GetRoot untuk mengirim pesan ini.

lParam

Menangani ke item.

Nilai kembali

Mengembalikan handel ke item jika berhasil. Untuk sebagian besar kasus, pesan mengembalikan nilai NULL untuk menunjukkan kesalahan. Lihat bagian Keterangan untuk detailnya.

Keterangan

Pesan ini akan mengembalikan NULL jika item yang diambil adalah simpul akar pohon. Misalnya, jika Anda menggunakan pesan ini dengan bendera TVGN_PARENT pada anak tingkat pertama dari simpul akar tampilan pohon, pesan akan mengembalikan NULL.

Anda juga bisa menggunakan salah satu makro terkait ini:
TreeView_GetChild
TreeView_GetDropHilight
TreeView_GetFirstVisible
TreeView_GetLastVisible
TreeView_GetNextSibling
TreeView_GetNextVisible
TreeView_GetParent
TreeView_GetPrevSibling
TreeView_GetPrevVisible
TreeView_GetRoot
TreeView_GetSelection

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