TreeView_DeleteAllItems macro (commctrl.h)

Exclui todos os itens de um controle de exibição de árvore.

Sintaxe

BOOL TreeView_DeleteAllItems(
   HWND hwnd
);

Parâmetros

hwnd

Tipo: HWND

Manipule para o controle de exibição de árvore.

Valor de retorno

Tipo: BOOL

Retorna TRUE se tiver êxito ou false caso contrário.

Observações

Depois que um item é excluído de um controle de exibição de árvore, seu identificador HTREEITEM é inválido e não pode ser usado.

A janela pai recebe um código de notificação TVN_DELETEITEM quando cada item é removido.

Se o rótulo do item estiver sendo editado, a operação de edição será cancelada e a janela pai receberá o código de notificação TVN_ENDLABELEDIT.

Você também pode excluir todos os itens com a macro TreeView_DeleteItem ou a mensagem TVM_DELETEITEM definindo lParam como TVI_ROOT.

Se o estilo de janela de um controle de exibição de árvore contiver TVS_NOSCROLL e todos os itens forem excluídos, novos itens não serão exibidos até que os estilos de janela sejam redefinidos. O código a seguir mostra uma maneira de garantir que os itens sejam sempre exibidos.

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

Requisitos