VisibilityItem (elemento)

Artículo
05/18/2015

El elemento de VisibilityItem determina la visibilidad estática de comandos y barras de herramientas. Cada entrada identifica un comando o un menú, y también un contexto asociado de la interfaz de usuario de comandos. Visual Studio detecta los comandos, menús, barras de herramientas y, y la visibilidad, sin cargar el VSPackages que los definen. El IDE usa el método de IsCmdUIContextActive para determinar si un contexto de interfaz de usuario de comandos está activa.

Después de que el Paquete se carga, Visual Studio espera que la visibilidad de comando se determina por el paquete VSPackage en lugar de VisibilityItem. Para determinar la visibilidad del comando, puede implementar el controlador de eventos BeforeQueryStatus o el método de QueryStatus , dependiendo de cómo haya implementado el comando.

Un comando o un menú que tienen un elemento de VisibilityItem sólo aparece cuando el contexto asociado está activa. Puede asociar un comando único, un menú, una barra de herramientas con uno o varios contextos de interfaz de usuario de comandos que incluye una entrada para cada combinación de comando-contexto. Si un comando o menú es asociado a varios contextos de interfaz de usuario de comandos, el comando o el menú está visible cuando de los contextos asociados de la interfaz de usuario de comandos está activa.

El elemento de VisibilityItem sólo se aplica a los comandos, los menús, y las barras de herramientas, no los grupos. Un elemento que no tiene un elemento relacionado de VisibilityItem está visible cuando el menú primario está activa.

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

Atributos y elementos

En las próximas secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo	Descripción
guid	Obligatorio. GUID del identificador de comandos de GUID/ID.
id	Obligatorio. El identificador del identificador de comandos de GUID/ID.
contexto (context)	Obligatorio. El contexto de la interfaz de usuario en el que el comando está visible.
Condition	Opcional. Vea Atributos condicionales del esquema XML de VSCT.

Elementos secundarios

None

Elementos primarios

Elemento	Descripción
VisibilityConstraints (Elemento)	El elemento de VisibilityConstraints determina la visibilidad estática de grupos de comandos y barras de herramientas.

Comentarios

Los contextos estándar de la interfaz de usuario de Visual Studio se definen en el archivo de ruta de instalación de Visual Studio SDK\VisualStudioIntegration\Common\Inc \ vsshlids.h así como en las clases de UIContextGuids y de UIContextGuids80 . Un conjunto más completo de contextos de interfaz de usuario es definido en la clase de VSConstants .

Ejemplo

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