TreeView_Expand makro (commctrl.h)

Makro TreeView_Expand memperluas atau menciutkan daftar item turunan yang terkait dengan item induk yang ditentukan, jika ada. Anda dapat menggunakan makro ini atau mengirim pesan TVM_EXPAND secara eksplisit.

Sintaksis

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

Parameter

hwnd

Jenis: HWND

Menangani ke kontrol tampilan pohon.

hitem

Jenis: HTREEITEM

Tangani ke item induk yang akan diperluas atau diciutkan.

code

Jenis: UINT

Bendera tindakan. Untuk daftar nilai yang mungkin, lihat deskripsi parameter wParam di TVM_EXPAND.

Mengembalikan nilai

Jenis: BOOL

Mengembalikan bukan nol jika operasi berhasil, atau nol sebaliknya.

Komentar

Memperluas simpul yang sudah diperluas, atau menciutkan simpul yang sudah diciutkan dianggap sebagai operasi yang berhasil dan makro mengembalikan nilai bukan nol. Mencoba memperluas atau menciutkan simpul yang tidak memiliki anak dianggap gagal dan nilai yang dikembalikan adalah nol.

Saat item pertama kali diperluas oleh pesan TVM_EXPAND, tindakan menghasilkan kode pemberitahuan TVN_ITEMEXPANDING dan TVN_ITEMEXPANDED dan bendera status TVIS_EXPANDEDONCE item diatur. Selama bendera status ini tetap ditetapkan, pesan TVM_EXPAND berikutnya tidak menghasilkan pemberitahuan TVN_ITEMEXPANDING atau TVN_ITEMEXPANDED. Untuk mengatur ulang bendera status TVIS_EXPANDEDONCE, Anda harus mengirim pesan TVM_EXPAND dengan bendera TVE_COLLAPSE dan TVE_COLLAPSERESET diatur. Mencoba mengatur TVIS_EXPANDEDONCE secara eksplisit akan mengakibatkan perilaku yang tidak dapat diprediksi.

Operasi perluas mungkin gagal jika pemilik kontrol treeview menolak operasi sebagai respons terhadap pemberitahuan TVN_ITEMEXPANDING.

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