TreeView_DeleteItem巨集（commctrl.h）

從樹視圖控件移除專案及其所有子系。您也可以明確傳送 TVM_DELETEITEM 訊息。

語法

BOOL TreeView_DeleteItem(
   HWND      hwnd,
   HTREEITEM hitem
);

hwnd

類型：HWND

樹視圖控件的句柄。

hitem

類型：HTREEITEM

HTREEITEM 要刪除之專案的句柄。如果 hitem 設為 TVI_ROOT，則會從樹視圖控件中刪除所有專案。您也可以使用 TreeView_DeleteAllItems 巨集來刪除所有專案。

類型：BOOL

如果成功，則傳回 true true，否則會 傳回 false。

刪除專案並不安全，以回應通知，例如 TVN_SELCHANGING。

刪除項目之後，它的句柄無效，且無法使用。

拿掉每個專案時，父視窗會收到 TVN_DELETEITEM 通知碼。

如果正在編輯專案標籤，則會取消編輯作業，且父視窗會收到 TVN_ENDLABELEDIT 通知碼。

如果您刪除樹視圖控件中具有 TVS_NOSCROLL 樣式的所有專案，後續新增的專案可能無法正確顯示。如需詳細資訊，請參閱 TreeView_DeleteAllItems。