共用方式為


TVM_DELETEITEM訊息

從樹狀檢視控制項移除專案及其所有子系。 您可以明確傳送此訊息,或使用 TreeView_DeleteItem 宏。

參數

wParam

必須為零。

lParam

要刪除之專案的HTREEITEM控制碼。 如果 lParam 設定為TVI_ROOT或 設為 Null,則會刪除所有專案。 您也可以使用 TreeView_DeleteAllItems 宏來刪除所有專案。

傳回值

如果成功,則傳回 TRUE ,否則傳回 FALSE

備註

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

刪除專案之後,其控制碼無效且無法使用。

當移除每個專案時,父視窗會收到 TVN_DELETEITEM 通知碼。

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

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

規格需求

需求
最低支援的用戶端
Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2003 [僅限桌面應用程式]
標頭
Commctrl.h