TreeView_Select macro (commctrl.h)

Artigo
10/24/2024

Seleciona o item de exibição de árvore especificado, rola o item para a exibição ou redesenha o item no estilo usado para indicar o destino de uma operação de arrastar e soltar. Você pode usar essa macro ou as macros TreeView_SelectItem, TreeView_SelectSetFirstVisibleou TreeView_SelectDropTarget ou enviar a mensagem TVM_SELECTITEM explicitamente.

Sintaxe

BOOL TreeView_Select(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

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.

code

Tipo: UINT

Sinalizador de ação. Esse parâmetro pode ser um dos seguintes valores:

Valor	Significado
TVGN_CARET	Define a seleção para o item especificado. A janela pai do controle recebe os códigos de notificação TVN_SELCHANGING e TVN_SELCHANGED.
TVGN_DROPHILITE	Redesenhe o item especificado no estilo usado para indicar o destino de uma operação de arrastar e soltar.
TVGN_FIRSTVISIBLE	Garante que o item especificado esteja visível e, se possível, o exiba na parte superior da janela do controle. Os controles de exibição de árvore exibem quantos itens caberem na janela. Se o item especificado estiver próximo à parte inferior da hierarquia de itens do controle, ele poderá não se tornar o primeiro item visível, dependendo de quantos itens se ajustarem na janela.

Valor de retorno

Tipo: BOOL

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

Observações

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.

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