TreeView_DeleteAllItems macro (commctrl.h)

Deletes all items from a tree-view control.

Syntax

BOOL TreeView_DeleteAllItems(
   HWND hwnd
);

Parameters

hwnd

Type: HWND

Handle to the tree-view control.

Return value

Type: BOOL

Returns TRUE if successful, or FALSE otherwise.

Remarks

Once an item is deleted from a tree-view control, its HTREEITEM handle is invalid and cannot be used.

The parent window receives a TVN_DELETEITEM notification code when each item is removed.

If the item label is being edited, the edit operation is canceled and the parent window receives the TVN_ENDLABELEDIT notification code.

You can also delete all items with the TreeView_DeleteItem macro or the TVM_DELETEITEM message by setting lParam to TVI_ROOT.

If the window style for a tree-view control contains TVS_NOSCROLL and all items are deleted, new items are not displayed until the window styles are reset. The following code shows one way to ensure that items are always displayed.

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

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header commctrl.h