TreeView_GetNextItem makro (commctrl.h)

2024-10-24

Mengambil item tampilan pohon yang berisi hubungan yang ditentukan ke item tertentu. Anda dapat menggunakan makro ini, menggunakan salah satu makro TreeView_Get yang dijelaskan di bawah ini, atau mengirim pesan TVM_GETNEXTITEM secara eksplisit.

Sintaksis

HTREEITEM TreeView_GetNextItem(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

Parameter

hwnd

Jenis: HWND

Tangani ke kontrol tampilan pohon.

hitem

Jenis: HTREEITEM

Menangani ke item.

code

Jenis: UINT

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

Nilai	Arti
TVGN_CARET	Mengambil item terpilih saat ini. Anda dapat menggunakan makro TreeView_GetSelection untuk mengirim pesan ini.
TVGN_CHILD	Mengambil item turunan pertama dari item yang ditentukan oleh parameter hitem . Anda bisa menggunakan makro TreeView_GetChild untuk mengirim pesan ini.
TVGN_DROPHILITE	Mengambil item yang merupakan target operasi seret dan letakkan. Anda bisa menggunakan makro TreeView_GetDropHilight untuk mengirim pesan ini.
TVGN_FIRSTVISIBLE	Mengambil item pertama yang terlihat. Anda dapat menggunakan makro TreeView_GetFirstVisible untuk mengirim pesan ini.
TVGN_NEXT	Mengambil item saudara berikutnya. Anda dapat menggunakan makro TreeView_GetNextSibling untuk mengirim pesan ini.
TVGN_NEXTSELECTED	Windows Vista dan yang lebih baru. Mengambil item terpilih berikutnya. Anda dapat menggunakan makro TreeView_GetNextSelected untuk mengirim pesan ini.
TVGN_NEXTVISIBLE	Mengambil item terlihat berikutnya yang mengikuti item yang ditentukan. Item yang ditentukan harus terlihat. Gunakan pesan TVM_GETITEMRECT untuk menentukan apakah item terlihat. Anda dapat 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 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 dapat menggunakan makro TreeView_GetPrevVisible untuk mengirim pesan ini.
TVGN_ROOT	Mengambil item paling atas atau sangat pertama dari kontrol tampilan pohon. Anda dapat menggunakan makro TreeView_GetRoot untuk mengirim pesan ini.

Mengembalikan nilai

Jenis: HTREEITEM

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

Komentar

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

Persyaratan

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

Bagikan melalui