Compartilhar via


TVM_SELECTITEM mensagem

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 enviar essa mensagem explicitamente ou usando a macro TreeView_Select, TreeView_SelectItem ou TreeView_SelectDropTarget .

Parâmetros

wParam

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

Valor Significado
TVGN_CARET
Define a seleção para o item especificado. A janela pai do controle de exibição de árvore 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.
TVSI_NOSINGLEEXPAND
Quando um único item é selecionado, garante que o modo de exibição de árvore não expanda os filhos desse item. Isso é válido somente se usado com o sinalizador TVGN_CARET.
Nota: Para usar esse sinalizador, você deve fornecer um manifesto especificando Comclt32.dll versão 6.0. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.

lParam

Identificador para um item. Se lParam for NULL, o controle será definido como sem nenhum item selecionado.

Valor retornado

Retornará TRUE se tiver êxito ou FALSE caso contrário.

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 do controle recebe os códigos de notificação TVN_ITEMEXPANDING e TVN_ITEMEXPANDED .

Usar a macro TreeView_SelectItem é equivalente a enviar a mensagem TVM_SELECTITEM com wParam definido como o valor TVGN_CARET. Usar a macro TreeView_SelectDropTarget é equivalente a enviar a mensagem TVM_SELECTITEM com wParam definido como o valor TVGN_DROPHILITE. Usar TreeView_SelectSetFirstVisible é equivalente a enviar a mensagem TVM_SELECTITEM com wParam 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]
parâmetro
Commctrl.h