Bagikan melalui


TreeView_Select makro (commctrl.h)

Memilih item tampilan pohon yang ditentukan, menggulir item ke dalam tampilan, atau menggambar ulang item dalam gaya yang digunakan untuk menunjukkan target operasi seret dan letakkan. Anda dapat menggunakan makro ini atau makro TreeView_SelectItem, TreeView_SelectSetFirstVisible, atau TreeView_SelectDropTarget, atau Anda dapat mengirim pesan TVM_SELECTITEM secara eksplisit.

Sintaksis

BOOL TreeView_Select(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

Parameter

hwnd

Jenis: HWND

Tangani ke kontrol tampilan pohon.

hitem

Jenis: HTREEITEM

Menangani ke item. Jika parameter hitem NULL, kontrol diatur agar tidak memiliki item yang dipilih.

code

Jenis: UINT

Bendera tindakan. Parameter ini bisa menjadi salah satu nilai berikut:

Nilai Arti
TVGN_CARET
Menyetel pilihan ke item yang diberikan. Jendela induk kontrol menerima kode pemberitahuan TVN_SELCHANGING dan TVN_SELCHANGED.
TVGN_DROPHILITE
Mengulangi item yang diberikan dalam gaya yang digunakan untuk menunjukkan target operasi seret dan letakkan.
TVGN_FIRSTVISIBLE
Memastikan bahwa item yang ditentukan terlihat, dan, jika memungkinkan, menampilkannya di bagian atas jendela kontrol. Kontrol tampilan pohon menampilkan item sebanyak yang akan pas di jendela. Jika item yang ditentukan berada di dekat bagian bawah hierarki item kontrol, item tersebut mungkin tidak menjadi item pertama yang terlihat, tergantung pada berapa banyak item yang pas di jendela.

Mengembalikan nilai

Jenis: BOOL

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya.

Komentar

Jika item yang ditentukan adalah anak dari item induk yang diciutkan, daftar item turunan induk diperluas untuk mengungkapkan item yang ditentukan. Dalam hal ini, jendela induk menerima kode pemberitahuan TVN_ITEMEXPANDING dan TVN_ITEMEXPANDED.

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