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を参照してください。