TreeView_SelectItem macro (commctrl.h)

Artigo
10/24/2024

Seleciona o item de exibição de árvore especificado. Você pode usar essa macro ou a macro TreeView_Select ou enviar a mensagem TVM_SELECTITEM explicitamente.

Sintaxe

BOOL TreeView_SelectItem(
   HWND      hwnd,
   HTREEITEM hitem
);

Parâmetros

hwnd

Tipo: HWND

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

hitem

Tipo: HTREEITEM

Manipule para um item. Se o parâmetro hitem for NULL, o controle será definido como sem nenhum item selecionado.

Valor de retorno

Tipo: BOOL

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

Observações

Quando você chama a macro TreeView_SelectItem, a janela pai do controle recebe os códigos de notificação TVN_SELCHANGING e TVN_SELCHANGED. Além disso, se o item especificado for o filho de um item pai recolhido, a lista pai de itens filho será expandida para revelar o item especificado. Nesse caso, a janela pai recebe os códigos de notificação TVN_ITEMEXPANDING e TVN_ITEMEXPANDED.

Usar a macro TreeView_SelectItem é equivalente a enviar a mensagem de TVM_SELECTITEM com seu sinalizador parâmetro definido como o valor TVGN_CARET.

Requisitos

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

Compartilhar via