macro TreeView_Select (commctrl.h)

  • Artigo

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_SelectSetFirstVisible ou TreeView_SelectDropTarget ou pode enviar a mensagem TVM_SELECTITEM explicitamente.

Sintaxe

void TreeView_Select(
   hwnd,
   hitem,
   code
);

Parâmetros

hwnd

Tipo: HWND

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

hitem

Tipo: HTREEITEM

Identificador 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 usar um dos valores a seguir:

Valor Significado
TVGN_CARET
 Define a seleção como o item especificado. A janela pai do controle recebe os códigos de notificação TVN_SELCHANGING e TVN_SELCHANGED .
TVGN_DROPHILITE
 Redesenha 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 exibe na parte superior da janela do controle. 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.

Valor retornado

Nenhum

Comentários

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

   
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