Elemento VisibilityItem
El VisibilityItem elemento determina la visibilidad estática de comandos y barras de herramientas. Cada entrada identifica un comando o menú, y también un contexto de interfaz de usuario de comando asociado. Visual Studio detecta comandos, menús y barras de herramientas, y su visibilidad, sin cargar los VSPackages que los definen. El IDE usa el IsCmdUIContextActive método para determinar si un contexto de interfaz de usuario de comando está activo.
Una vez cargado VSPackage, Visual Studio espera que la visibilidad del comando esté determinada por VSPackage en lugar de .VisibilityItem Para determinar la visibilidad del comando, puede implementar el BeforeQueryStatus controlador de eventos o el QueryStatus método, en función de cómo haya implementado el comando.
Un comando o menú que tiene un VisibilityItem elemento solo aparece cuando el contexto asociado está activo. Puede asociar un solo comando, menú o barra de herramientas con uno o varios contextos de interfaz de usuario de comandos mediante la inclusión de una entrada para cada combinación de contexto de comandos. Si un comando o menú está asociado a varios contextos de interfaz de usuario de comandos, el comando o menú está visible cuando cualquiera de los contextos de interfaz de usuario de comandos asociados está activo.
El VisibilityItem elemento solo se aplica a comandos, menús y barras de herramientas, no a grupos. Un elemento que no tiene un elemento relacionado VisibilityItem está visible cada vez que su menú primario está activo.
Sintaxis
<VisibilityItem
guid="cmdGuidMyProductCommands"
id="cmdidAddWidget"
context="guidNotViewSourceMode"/>
Atributos y elementos
En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.
Atributos
| Atributo | Descripción |
|---|---|
| guid | Necesario. GUID del identificador de comando GUID/ID. |
| id | Necesario. Identificador del identificador de comando GUID/ID. |
| context | Necesario. Contexto de la interfaz de usuario en el que el comando está visible. |
| Condición | Opcional. Consulte Atributos condicionales. |
Elementos secundarios
Ninguno
Elementos primarios
| Elemento | Descripción |
|---|---|
| Elemento VisibilityConstraints | El VisibilityConstraints elemento 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 la ruta de instalación del SDK de Visual Studio\VisualStudioIntegration\Common\Inc\vsshlids.h, así como en las UIContextGuids clases y UIContextGuids80 . En la VSConstants clase se define un conjunto más completo de contextos de interfaz de usuario.
Ejemplo
<VisibilityConstraints>
<VisibilityItem guid="cmdSetGuidMyProductCommands" id="cmdidAddWidget"
context="guidNotViewSourceMode"/>
</VisibilityConstraints>