TreeView_DeleteItem makro (commctrl.h)

2024-10-24

Menghapus item dan semua turunannya dari kontrol tampilan pohon. Anda juga dapat mengirim pesan TVM_DELETEITEM secara eksplisit.

Sintaksis

BOOL TreeView_DeleteItem(
   HWND      hwnd,
   HTREEITEM hitem
);

Parameter

hwnd

Jenis: HWND

Tangani ke kontrol tampilan pohon.

hitem

Jenis: HTREEITEM

HTREEITEM menangani item yang akan dihapus. Jika hitem diatur ke TVI_ROOT, semua item akan dihapus dari kontrol tampilan pohon. Anda juga dapat menggunakan makro TreeView_DeleteAllItems untuk menghapus semua item.

Mengembalikan nilai

Jenis: BOOL

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya.

Komentar

Tidak aman untuk menghapus item sebagai respons terhadap pemberitahuan seperti TVN_SELCHANGING.

Setelah item dihapus, handelnya 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.

Jika Anda menghapus semua item dalam kontrol tampilan pohon yang memiliki gaya TVS_NOSCROLL, item yang kemudian ditambahkan mungkin tidak ditampilkan dengan benar. Untuk informasi selengkapnya, lihat TreeView_DeleteAllItems.

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