__UIHWINFLAGS Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Controla as características de uma janela de hierarquia da interface do usuário.
Esta enumeração tem um atributo FlagsAttribute que permite uma combinação bit a bit dos valores membros dela.
public enum class __UIHWINFLAGS
public enum class __UIHWINFLAGS
enum __UIHWINFLAGS
[System.Flags]
public enum __UIHWINFLAGS
[<System.Flags>]
type __UIHWINFLAGS =
Public Enum __UIHWINFLAGS
- Herança
-
__UIHWINFLAGS
- Atributos
Campos
| UIHWF_ActAsProjectTypeWin | 1 | Determina se a janela da hierarquia da interface do usuário rastreia a seleção do ambiente. |
| UIHWF_DoNotSortRootNodes | 2 | O padrão é classificação alfa em barras de ferramentas habilitadas para legendas na janela de ferramentas do UIHierarchyWindow. Use VSFPROPID_ToolbarHost para acessar a implementação da janela IVsToolWindowToolbarHost . |
| UIHWF_ForceSingleSelect | 8 | Força a seleção de um único nó em uma hierarquia. |
| UIHWF_HandlesCmdsAsActiveHierarchy | 16384 | Isso é para o Windows que manipula comandos quando eles são a hierarquia ativa, mesmo que sua hierarquia não tenha foco (como projeto/Adicionar item). |
| 1024 | Cria uma hierarquia raiz oculta que é o pai de seus nós de nível superior. |
|
| 16 | Indica que o IVsHierarchy ponteiro passado com a chamada para Init(IVsUIHierarchy, UInt32, Object) é, na verdade, uma hierarquia raiz oculta especial |
|
| UIHWF_LinesAtRoot | 64 | Estilo definido no modo de exibição de árvore. |
| UIHWF_NoStateIcon | 256 | Especifica se a janela de hierarquia mostra ícones de estado. Um TreeView pode ter dois canais de ícone, dos quais o ícone de estado é o canal de ícones mais à esquerda. Por exemplo, na janela do projeto, o ícone de estado pode mostrar o estado de entrada/saída do controle do código-fonte do item, enquanto o ícone normal mostra o glifo normal para esse tipo de arquivo. Se não quiser que sua janela de hierarquia mostre os ícones de estado, especifique esse sinalizador em uma chamada para Init(IVsUIHierarchy, UInt32, Object) . |
| UIHWF_PropagateAltHierarchyItem | 4096 | Se especificado, quando UIHierarchy o seleciona um nó, o UIHierarchy cria hierarquias alternativas. |
| UIHWF_RouteCmdidDelete | 8192 | Controla o tratamento do comando excluir na janela hierarquia. |
| UIHWF_SortChildNodes | 128 | Especifica se os nós não raiz na janela de hierarquia devem ser classificados ou deixados na ordem em que a hierarquia os enumera para a janela de hierarquia ( VSHPROPID_FirstChild e VSHPROPID_NextSibling ). |
| UIHWF_SupportToolWindowToolbars | 4 | Para controlar os recursos que pertencem à barra de ferramentas de uma janela de ferramentas, chame GetProperty(Int32, Object) e especifique um valor de VSFPROPID_ToolbarHost . Isso permite que você acesse a implementação da janela de ferramentas IVsToolWindowToolbarHost e adicione uma barra de ferramentas. Essa abordagem só será válida se o Init(IVsUIHierarchy, UInt32, Object) método for chamado e um valor de UIHWF_SupportToolWindowToolbars for especificado para o |
| 32 | Indica que o IVsHierarchy ponteiro passado com a chamada para Init(IVsUIHierarchy, UInt32, Object) é, na verdade, uma hierarquia raiz oculta especial. |
Comentários
O uso do UIHWF_ActAsProjectTypeWin valor com o Init faz com que a janela hierarquia da interface do usuário opere como uma janela de ferramentas de tipo de projeto. Nesse caso, a janela hierarquia da interface do usuário rastreia o contexto de seleção global. A seleção é sempre mostrada quando o contexto de seleção global corresponde a um item contido, independentemente de a janela ter foco. Se você não passar nesse sinalizador, a janela hierarquia da interface do usuário atuará como uma janela de ferramentas genérica e, portanto, não rastreará o contexto de seleção global nem pintará com uma seleção até que ela tenha foco.
Definir o UIHWF_DoNotSortRootNodes sinalizador desativa esse comportamento e faz com que os nós sejam exibidos na ordem em que foram adicionados. Quando a classificação está no padrão, o ambiente verifica primeiro se as hierarquias dão suporte VSHPROPID_SortPriority e classifica usando os valores retornados dessa propriedade antes de reverter para classificar em ordem alfabética pela propriedade Caption.
UIHWF_ForceSingleSelect forç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 impedir a seleção múltipla. Por padrão, todas as janelas de hierarquia da interface do usuário dão 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 dar suporte a vários usos de seleção UIHWF_UseSolutionAsHiddenRootHierarchy para indicar que a SID_SVsSolutionObject hierarquia deve ser usada como a hierarquia de raiz oculta especial. Essa hierarquia é o mesmo objeto que lida com várias seleções para Gerenciador de soluções. Nesse caso, a hierarquia passada com a chamada para Init é mostrada na janela hierarquia da interface do usuário.
UIHWF_InitWithHiddenParentRoot é uma alternativa para especificar UIHWF_InitWithHiddenRootHierarchy . Se você quiser que sua hierarquia raiz oculta realmente seja o pai de seus nós de nível superior (que nesse caso não seriam necessariamente hierarquias separadas), especifique esse sinalizador. Se você usar esse sinalizador, defina o VSITEMID_ROOT dessa hierarquia como VSHPROPID_ExpandByDefault , para que a janela hierarquia expanda automaticamente para mostrar os nós de nível superior.
Observação
AddUIHierarchyNão é permitido chamar em uma janela de hierarquia de interface do usuário com esse sinalizador porque todos os nós de nível superior devem ser filhos da raiz pai oculta.
Uma 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 é, na verdade, uma hierarquia de raiz oculta especial. Essa hierarquia não é mostrada na janela hierarquia da interface do usuário, mas é usada quando a seleção é uma seleção de hierarquia entre raiz. Todas as hierarquias que você deseja mostrar devem ser adicionadas usando AddUIHierarchy .
UIHWF_LinesAtRoot é o estilo definido no modo de exibição de árvore. Esse membro é equivalente a TVS_LINESATROOT. Ele fornece o sinal de mais (+) no nó raiz.
Quando o UIHWF_PropagateAltHierarchyItem valor é especificado, quando o UIHierarchy seleciona um nó, ele chama GetProperty duas vezes, uma vez com um valor de VSHPROPID_AltHierarchy no propid parâmetro e uma vez com um valor de VSHPROPID_AltItemid . Nessa chamada, a hierarquia pode fornecer uma hierarquia alternativa e um ItemID de hierarquia alternativo ao contexto de seleção. Isso permite que a hierarquia especifique qual ItemID de hierarquia está sendo enviada para o contexto de seleção quando as seleções são feitas na UIHierarchy janela. Esse é o cenário usado pelo Gerenciador de macros.
O UIHWF_RouteCmdidDelete sinalizador é usado no Init método para informar à janela de hierarquia que as hierarquias contidas nela tratarão seus próprios cmdidDelete comandos, em vez de implementar IVsHierarchyDeleteHandler . Como resultado, a janela hierarquia lida com a exclusão na maneira consistente e imposta pelo ambiente.