TreeView_DeleteAllItems makro (commctrl.h)

2024-10-24

Menghapus semua item dari kontrol tampilan pohon.

Sintaksis

BOOL TreeView_DeleteAllItems(
   HWND hwnd
);

Parameter

hwnd

Jenis: HWND

Tangani ke kontrol tampilan pohon.

Mengembalikan nilai

Jenis: BOOL

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya.

Komentar

Setelah item dihapus dari kontrol tampilan pohon, handel HTREEITEM tidak valid dan tidak dapat digunakan.

Jendela induk menerima kode pemberitahuan TVN_DELETEITEM saat setiap item dihapus.

Jika label item sedang diedit, operasi edit dibatalkan dan jendela induk menerima kode pemberitahuan TVN_ENDLABELEDIT.

Anda juga dapat menghapus semua item dengan makro TreeView_DeleteItem atau pesan TVM_DELETEITEM dengan mengatur lParam ke TVI_ROOT.

Jika gaya jendela untuk kontrol tampilan pohon berisi TVS_NOSCROLL dan semua item dihapus, item baru tidak ditampilkan hingga gaya jendela diatur ulang. Kode berikut menunjukkan salah satu cara untuk memastikan bahwa item selalu ditampilkan.

DWORD styles = GetWindowLong(hwnd, GWL_STYLE);
TreeView_DeleteAllItems(hwnd);
SetWindowLong(hwnd, GWL_STYLE, styles);

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