Elemento VisibilityItem

Artigo
10/10/2023

O VisibilityItem elemento determina a visibilidade estática de comandos e barras de ferramentas. Cada entrada identifica um comando ou menu e também um contexto de interface do usuário de comando associado. Visual Studio detecta comandos, menus e barras de ferramentas e sua visibilidade, sem carregar os VSPackages que os definem. O IDE usa o método para determinar se um contexto de interface do IsCmdUIContextActive usuário de comando está ativo.

Depois que o VSPackage é carregado, o Visual Studio espera que a visibilidade do comando seja determinada pelo VSPackage em vez do VisibilityItem. Para determinar a visibilidade do comando, você pode implementar o manipulador de eventos ou o método, dependendo de como você implementou o BeforeQueryStatus QueryStatus comando.

Um comando ou menu que tem um VisibilityItem elemento aparece somente quando o contexto associado está ativo. Você pode associar um único comando, menu ou barra de ferramentas a um ou mais contextos de interface do usuário de comando incluindo uma entrada para cada combinação de contexto de comando. Se um comando ou menu estiver associado a vários contextos de interface do usuário de comando, o comando ou menu ficará visível quando qualquer um dos contextos de interface do usuário de comando associado estiver ativo.

O VisibilityItem elemento se aplica somente a comandos, menus e barras de ferramentas, não a grupos. Um elemento que não tem um elemento relacionado VisibilityItem fica visível sempre que seu menu pai está ativo.

Syntax

<VisibilityItem
  guid="cmdGuidMyProductCommands"
  id="cmdidAddWidget"
  context="guidNotViewSourceMode"/>

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo	Descrição
guid	Obrigatório. O GUID do identificador de comando GUID/ID.
ID	Obrigatório. A ID do identificador de comando GUID/ID.
contexto	Obrigatório. O contexto da interface do usuário no qual o comando está visível.
Condição	Opcional. Consulte Atributos condicionais.

Elementos filho

Nenhum

Elementos pai

Elemento	Descrição
Elemento VisibilityConstraints	O `VisibilityConstraints` elemento determina a visibilidade estática de grupos de comandos e barras de ferramentas.

Comentários

Os contextos padrão da interface do usuário do Visual Studio são definidos no caminho de instalação do SDK do Visual Studio\VisualStudioIntegration\Common\Inc\vsshlids.h arquivo, bem como nas UIContextGuids classes e UIContextGuids80 . Um conjunto mais completo de contextos de interface do VSConstants usuário é definido na classe.

Exemplo

<VisibilityConstraints>
  <VisibilityItem guid="cmdSetGuidMyProductCommands"     id="cmdidAddWidget"
    context="guidNotViewSourceMode"/>
</VisibilityConstraints>

Compartilhar via