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

void TreeView_SelectSetFirstVisible(
   hwnd,
   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.

Retornar valor

Nenhum

Comentários

Os controles de exibição de árvore exibem quantos itens caberão 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 cabem 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 .

O uso da macro TreeView_SelectSetFirstVisible é equivalente ao envio da mensagem TVM_SELECTITEM com seu parâmetro de sinalizador definido como o valor TVGN_FIRSTVISIBLE.

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