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 [僅限桌面應用程式] |
標頭 |
|