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 を返し、それ以外の場合は FALSE 返します。

備考

TVN_SELCHANGINGなどの通知に応じてアイテムを削除しても安全ではありません。

項目が削除されると、そのハンドルは無効になり、使用できません。

親ウィンドウは、各項目が削除されたときに TVN_DELETEITEM 通知コードを受け取ります。

アイテム ラベルが編集されている場合、編集操作は取り消され、親ウィンドウは TVN_ENDLABELEDIT 通知コードを受け取ります。

TVS_NOSCROLL スタイルを持つツリー ビュー コントロール内のすべての項目を削除すると、後で追加された項目が正しく表示されないことがあります。 詳細については、TreeView_DeleteAllItemsを参照してください。

必要条件