Elemento VisibilityItem
L'elemento VisibilityItem determina la visibilità statica dei comandi e delle barre degli strumenti. Ogni voce identifica un comando o un menu e anche un contesto dell'interfaccia utente del comando associato. Visual Studio rileva comandi, menu e barre degli strumenti e la relativa visibilità, senza caricare i pacchetti VSPackage che li definiscono. L'IDE usa il IsCmdUIContextActive metodo per determinare se un contesto dell'interfaccia utente del comando è attivo.
Dopo il caricamento del pacchetto VSPackage, Visual Studio prevede che la visibilità dei comandi venga determinata dal VSPackage anziché da VisibilityItem. Per determinare la visibilità del comando, è possibile implementare il BeforeQueryStatus gestore eventi o il QueryStatus metodo , a seconda della modalità di implementazione del comando.
Un comando o un menu con un VisibilityItem elemento viene visualizzato solo quando il contesto associato è attivo. È possibile associare un singolo comando, menu o barra degli strumenti a uno o più contesti dell'interfaccia utente dei comandi includendo una voce per ogni combinazione di contesto di comando. Se un comando o un menu è associato a più contesti dell'interfaccia utente dei comandi, il comando o il menu è visibile quando uno dei contesti dell'interfaccia utente dei comandi associati è attivo.
L'elemento VisibilityItem si applica solo a comandi, menu e barre degli strumenti, non ai gruppi. Un elemento che non dispone di un elemento correlato VisibilityItem è visibile ogni volta che il menu padre è attivo.
Sintassi
<VisibilityItem
guid="cmdGuidMyProductCommands"
id="cmdidAddWidget"
context="guidNotViewSourceMode"/>
Attributi ed elementi
Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.
Attributi
| Attributo | Descrizione |
|---|---|
| guid | Obbligatorio. GUID dell'identificatore di comando GUID/ID. |
| ID | Obbligatorio. ID dell'identificatore di comando GUID/ID. |
| context | Obbligatorio. Contesto dell'interfaccia utente in cui il comando è visibile. |
| Condizione | Facoltativo. Vedere Attributi condizionali. |
Elementi figlio
None
Elementi padre
| Elemento | Descrizione |
|---|---|
| Elemento VisibilityConstraints | L'elemento VisibilityConstraints determina la visibilità statica dei gruppi di comandi e barre degli strumenti. |
Osservazioni:
I contesti standard dell'interfaccia utente di Visual Studio sono definiti nel percorso di installazione di Visual Studio SDK\VisualStudioIntegration\Common\Inc\vsshlids.h e nelle UIContextGuids classi e UIContextGuids80 . Nella classe è definito un set più completo di contesti dell'interfaccia VSConstants utente.
Esempio
<VisibilityConstraints>
<VisibilityItem guid="cmdSetGuidMyProductCommands" id="cmdidAddWidget"
context="guidNotViewSourceMode"/>
</VisibilityConstraints>