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 [デスクトップ アプリのみ] |
ヘッダー |
|