Enumeração __UIHWINFLAGS

 

Publicado: abril de 2016

Controla as características de uma janela de hierarquia de interface do usuário.

Esta enumeração tem um atributo FlagsAttribute que permite uma combinação bit a bit de seus valores de membro.

Namespace:   Microsoft.VisualStudio.Shell.Interop
Assembly:  Microsoft.VisualStudio.Shell.Interop (em Microsoft.VisualStudio.Shell.Interop.dll)

Sintaxe

[FlagsAttribute]
public enum __UIHWINFLAGS

[FlagsAttribute]
public enum class __UIHWINFLAGS

[<FlagsAttribute>]
type __UIHWINFLAGS

<FlagsAttribute>
Public Enumeration __UIHWINFLAGS

Membros

	Nome do membro	Descrição
	UIHWF_ActAsProjectTypeWin	Determina se a janela hierarquia de interface do usuário controla a seleção do ambiente.
	UIHWF_DoNotSortRootNodes	Padrão é o alfa classificação nas barras de ferramentas legenda habilitada na UIHierarchyWindow janela da ferramenta.Use VSFPROPID_ToolbarHost para acessar a janela IVsToolWindowToolbarHost implementação.
	UIHWF_ForceSingleSelect	Seleção de forças de um único nó em uma hierarquia.
	UIHWF_HandlesCmdsAsActiveHierarchy	Isso é para windows que lidam com os comandos quando estão a hierarquia ativa mesmo se sua hierarquia não tem o foco (como Item de projeto/Adicionar).
	UIHWF_InitWithHiddenParentRoot	Cria uma hierarquia de raiz oculto que é o pai do nó de nível superior.
	UIHWF_InitWithHiddenRootHierarchy	Indica que o IVsHierarchy ponteiro passado com a chamada para Init é realmente uma hierarquia de raiz oculto especial
	UIHWF_LinesAtRoot	Estilo definido no modo de exibição de árvore.
	UIHWF_NoStateIcon	Especifica se a janela hierarquia mostra ícones de estado.Um treeview pode ter dois canais de ícone, do qual o ícone de estado é o canal mais à esquerda do ícone.Por exemplo, na janela projeto o ícone de estado pode mostrar o estado do item, in/out do controle de origem, enquanto o ícone normal mostra o glifo normal para esse tipo de arquivo.Se não desejar que a janela de hierarquia para mostrar os ícones de estado, em seguida, especifique esse sinalizador em uma chamada para Init.
	UIHWF_PropagateAltHierarchyItem	Se especificado, quando UIHierarchy seleciona um nó, UIHierarchy cria hierarquias alternativas.
	UIHWF_RouteCmdidDelete	Controla o tratamento do comando delete dentro da janela de hierarquia.
	UIHWF_SortChildNodes	Especifica se nós de não-raiz na sua janela de hierarquia devem ser classificados ou deixados na ordem em que a hierarquia enumera-los para a janela de hierarquia (VSHPROPID_FirstChild e VSHPROPID_NextSibling).
	UIHWF_SupportToolWindowToolbars	Para controlar os recursos relativos à barra de ferramentas da janela da ferramenta, chamada GetProperty e especifique um valor de VSFPROPID_ToolbarHost.Isso permite que você acesse a janela da ferramenta IVsToolWindowToolbarHost implementação e adicionar uma barra de ferramentas.Essa abordagem só é válida se a Init método é chamado e um valor de UIHWF_SupportToolWindowToolbars é especificado para o grfUIHWF parâmetro.
	UIHWF_UseSolutionAsHiddenRootHierarchy	Indica que o IVsHierarchy ponteiro passado com a chamada para Init é realmente uma hierarquia de raiz oculto especial.

Comentários

Usando o UIHWF_ActAsProjectTypeWin de valor com o Init faz com que a janela hierarquia de interface do usuário operar como uma janela de ferramenta do tipo de projeto.Nesse caso, a janela hierarquia de interface do usuário rastreia o contexto da seleção global.A seleção é sempre exibida quando o contexto da seleção global corresponde a um item contido, independentemente de se a janela tem foco.Se você não passar esse sinalizador, em seguida, a janela hierarquia de interface do usuário atua como uma janela de ferramenta genérica e, portanto, não controlar o contexto global de seleção, nem se desenha com uma seleção até que ele tem o foco.

Definindo a UIHWF_DoNotSortRootNodes sinalizador desativa esse comportamento e faz com que os nós a serem exibidos na ordem em que foram adicionados.Quando a classificação é o padrão, o ambiente primeiro verifica se as hierarquias oferecem suporte VSHPROPID_SortPrioritye classifica usando os valores retornados da propriedade antes de voltar a classificação em ordem alfabética pela propriedade Caption.

UIHWF_ForceSingleSelectforça a seleção de um único nó em uma hierarquia.Por exemplo, uma janela de hierarquia de interface do usuário com vários nós de nível superior pode usar esse sinalizador para não permitir seleção múltipla.Por padrão, todas as janelas de hierarquia de interface do usuário, suporte à seleção múltipla.

Uma janela de hierarquia de interface do usuário com vários nós de nível superior e que deseja oferecer suporte a vários usos de seleção UIHWF_UseSolutionAsHiddenRootHierarchy para indicar que o SID_SVsSolutionObject hierarquia deve ser usada como a hierarquia de raiz oculto especial.Essa hierarquia é o mesmo objeto que lida com várias seleções para Solution Explorer.Nesse caso, a hierarquia é passado com a chamada para Init é mostrado na janela de hierarquia de interface do usuário.

UIHWF_InitWithHiddenParentRooté uma alternativa à especificação de UIHWF_InitWithHiddenRootHierarchy.Se desejar que a sua hierarquia de raiz ocultos, na verdade, ser o pai de seus nós de nível superior (que nesse caso não necessariamente seria hierarquias separadas), especifique esse sinalizador.Se você usar esse sinalizador, defina a VSITEMID_ROOT dessa hierarquia para VSHPROPID_ExpandByDefault, de modo que a janela hierarquia expande automaticamente para mostrar os nós de nível superior.

Observação
Chamando AddUIHierarchy em uma hierarquia de interface do usuário janela com esse sinalizador não é permitida porque todos os nós de nível superior devem ser filhos da raiz pai oculto.

A UIHierarchy janela que usa vários nós de nível superior e que deseja oferecer suporte a várias seleções usa UIHWF_InitWithHiddenParentRoot para indicar que o IVsHierarchy ponteiro passado com a chamada para Init é realmente uma hierarquia de raiz oculto especial.Essa hierarquia não é mostrada na janela de hierarquia de interface do usuário, mas é usada quando a seleção é uma seleção de hierarquia de cross-raiz.Todas as hierarquias que você deseja mostrar devem ser adicionadas usando AddUIHierarchy.

UIHWF_LinesAtRooto estilo é definido no modo de exibição de árvore.Esse membro é equivalente a TVS_LINESATROOT.Ele fornece o sinal de mais (+) sinal no nó raiz.

Quando o UIHWF_PropagateAltHierarchyItem valor for especificado, quando o UIHierarchy seleciona um nó, ele chama GetProperty duas vezes, uma vez com um valor de VSHPROPID_AltHierarchy na propid parâmetro e uma vez com um valor de VSHPROPID_AltItemid.Nesta chamada, a hierarquia, em seguida, pode fornecer uma hierarquia de alternativa e uma hierarquia ItemID alternativa para o contexto da seleção.Isso permite que a hierarquia especificar qual hierarquia ItemID está sendo enviado para o contexto de seleção, quando as seleções são feitas na UIHierarchy janela.Esse é o cenário usado pelo Gerenciador de Macro.

O UIHWF_RouteCmdidDelete sinalizador é usado na Init método para informar a janela hierarquia que as hierarquias contidas nele irá lidar com seus próprios cmdidDelete comandos, em vez de implementar IVsHierarchyDeleteHandler.Como resultado, a janela hierarquia lida com a exclusão da imposta pela ambiente de maneira consistente.

COM assinatura

De vsshell.idl:

[C++]

Consulte também

Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo