TreeView_SelectSetFirstVisible macro (commctrl.h)

Rola o controle de exibição de árvore verticalmente para garantir que o item especificado esteja visível. Se possível, o item especificado se tornará o primeiro item visível na parte superior da janela do controle. Você pode usar essa macro ou a macro TreeView_Select ou enviar a mensagem TVM_SELECTITEM explicitamente.

Sintaxe

BOOL TreeView_SelectSetFirstVisible(
   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

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.

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_SelectSetFirstVisible é equivalente a enviar a mensagem TVM_SELECTITEM com seu sinalizador parâmetro definido como o valor TVGN_FIRSTVISIBLE.

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