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