TreeView_DeleteAllItems マクロ (commctrl.h)

ツリービューコントロールからすべての項目を削除します。

構文

BOOL TreeView_DeleteAllItems(
   HWND hwnd
);

hwnd

型: HWND

ツリービューコントロールへのハンドル。

型: BOOL

成功した場合 TRUE を返し、それ以外の場合は FALSE 返します。

ツリービューコントロールから項目が削除されると、その HTREEITEM ハンドルは無効になり、使用できません。

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

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

lParam を TVI_ROOT に設定して、TreeView_DeleteItem マクロまたは TVM_DELETEITEM メッセージ持つすべてのアイテムを削除することもできます。

ツリービューコントロールのウィンドウスタイルにTVS_NOSCROLLが含まれており、すべての項目が削除された場合、ウィンドウスタイルがリセットされるまで新しい項目は表示されません。次のコードは、アイテムが常に表示されるようにする 1 つの方法を示しています。

DWORD styles = GetWindowLong(hwnd, GWL_STYLE);
TreeView_DeleteAllItems(hwnd);
SetWindowLong(hwnd, GWL_STYLE, styles);