macro TreeView_DeleteAllItems (commctrl.h)

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

Sintaxe

void TreeView_DeleteAllItems(
   hwnd
);

Parâmetros

hwnd

Tipo: HWND

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

Retornar valor

Nenhum

Comentários

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

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	commctrl.h