mensagem TVM_DELETEITEM

Remove um item e todos os seus filhos de um controle de exibição de árvore. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_DeleteItem .

Parâmetros

wParam

Deve ser zero.

lParam

Identificador HTREEITEM para o item a ser excluído. Se lParam estiver definido como TVI_ROOT ou como NULL, todos os itens serão excluídos. Você também pode usar a macro TreeView_DeleteAllItems para excluir todos os itens.

Valor retornado

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

Comentários

Não é seguro excluir itens em resposta a uma notificação, como TVN_SELCHANGING.

Depois que um item é excluído, seu identificador é 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 .

Se você excluir todos os itens em um controle de exibição de árvore que tenha o estilo TVS_NOSCROLL , os itens adicionados posteriormente poderão não ser exibidos corretamente. Para obter mais informações, consulte TreeView_DeleteAllItems.

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]
Cabeçalho	Commctrl.h