TreeView_SelectSetFirstVisible makro (commctrl.h)

Menggulir kontrol tampilan pohon secara vertikal untuk memastikan bahwa item yang ditentukan terlihat. Jika memungkinkan, item yang ditentukan menjadi item pertama yang terlihat di bagian atas jendela kontrol. Anda dapat menggunakan makro ini atau makro TreeView_Select, atau Anda bisa mengirim pesan TVM_SELECTITEM secara eksplisit.

Sintaksis

BOOL TreeView_SelectSetFirstVisible(
   HWND      hwnd,
   HTREEITEM hitem
);

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.

Mengembalikan nilai

Jenis: BOOL

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya.

Komentar

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.

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.

Menggunakan makro TreeView_SelectSetFirstVisible setara dengan mengirim pesan TVM_SELECTITEM dengan bendera parameter yang diatur ke nilai TVGN_FIRSTVISIBLE.

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