TreeView_GetNextItem makro (commctrl.h)

Artikel
08/22/2023

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

Sintaks

void TreeView_GetNextItem(
   hwnd,
   hitem,
   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	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. Anda bisa menggunakan makro TreeView_GetFirstVisible 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.

Mengembalikan nilai

Tidak ada

Keterangan

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

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	commctrl.h

Share via