definisce una voce di menu. questi sono i sei tipi di menu: Contesto, menu, MenuController, MenuControllerLatched, barra degli strumenti e ToolWindowToolbar.
Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.
Attributi
Attributo
Descrizione
GUID
Obbligatorio. GUID dell'identificatore di comando di GUID/ID.
id
Obbligatorio. ID dell'identificatore di comando di GUID/ID.
priority
Parametro facoltativo. un valore numerico che specifica la posizione relativa di un menu in un gruppo di menu.
ToolbarPriorityInBand
Parametro facoltativo. Un valore numerico che specifica la posizione relativa di una barra degli strumenti in una banda quando la finestra è ancorata.
type
Parametro facoltativo. Un file di MSSCCPRJ.SCC necessario utilizzare esattamente il formato definito.
se non presentare, il tipo predefinito è menu.
Contesto
Un menu di scelta rapida che viene visualizzato quando un utente fa clic con il pulsante destro del mouse su una finestra. Un menu di scelta rapida presenta le caratteristiche seguenti:
Non utilizza i campi di priorità padre e quando il menu deve essere visualizzato come menu di scelta rapida.
Può essere utilizzato come sottomenu e anche come menu di scelta rapida. In questo caso, entrambi i campi di priorità che ID gruppo vengono rispettate.
non è sempre disponibile.
Verrà visualizzato un menu di scelta rapida solo se le condizioni seguenti sono vere:
La finestra che ospitano visualizzare.
Un gestore del mouse nel package VS rileva un fare clic con il pulsante destro del mouse sulla finestra e quindi chiama un metodo che gestisce il comando.
Il menu di scelta rapida visualizza chiamando il metodo di ShowContextMenu (l'approccio consigliato) o il metodo di ShowContextMenu .
Menu
fornisce un menu a discesa. Un menu a discesa presenta le caratteristiche seguenti:
Rispettano il padre nella definizione.
Deve disporre di un gruppo padre, o un CommandPlacement a un gruppo.
Può essere un sottomenu in qualsiasi altro tipo di menu.
Visualizza automaticamente ogni volta che il menu padre viene visualizzato.
Non è richiesta l'implementazione di codice di un VSPackage di farvi visualizzare.
MenuController
Fornisce un menu a discesa del pulsante di menu combinato, che viene in genere utilizzato in barre degli strumenti. Un menu di MenuController presenta le caratteristiche seguenti:
Deve essere contenuto in un altro menu del padre o CommandPlacement.
Rispettano il padre nella definizione.
Può avere qualsiasi tipo di menu al relativo padre.
Viene automaticamente reso disponibile ogni volta che il menu padre viene visualizzato.
Non richiede il supporto a livello di codice del viene visualizzato il menu.
Un comando dal menu pulsante di menu combinato viene visualizzato sul pulsante del menu. Il comando consente di visualizzare ha una delle seguenti caratteristiche:
È l'ultimo comando utilizzato se il comando ancora visualizzato e abilitato.
È il comando nella prima visualizzazione.
MenuControllerLatched
Fornisce un menu a discesa del pulsante di menu combinato per il quale un comando possono essere specificati come la selezione predefinita contrassegnando il comando come chiuso.
Un comando chiuso è un comando che è contrassegnato nel menu come selezionato, in genere visualizzato un segno di spunta. Un comando è possibile contrassegnare come chiuso se include il flag di OLECMDF_LATCHED impostato su in un'implementazione del metodo di QueryStatus dell'interfaccia di IOleCommandTarget . Un menu di MenuControllerLatched presenta le caratteristiche seguenti:
Deve essere contenuto in un altro menu a un gruppo padre o un CommandPlacement.
Rispettano il padre nella definizione.
Può avere qualsiasi tipo di menu al relativo padre.
Viene reso disponibile ogni volta che il menu padre viene visualizzato.
Non richiede il supporto a livello di codice del viene visualizzato il menu.
Un comando dal menu pulsante di menu combinato viene visualizzato sul pulsante del menu. Il comando consente di visualizzare ha una delle seguenti caratteristiche:
È il comando viene visualizzata per la prima volta che viene chiuso.
È il comando nella prima visualizzazione.
Barra degli strumenti
Fornisce una barra degli strumenti. Una barra degli strumenti presenta le caratteristiche seguenti:
Ignora il padre nella definizione.
Non può essere reso a un sottomenu di qualsiasi gruppo, neanche utilizzando CommandPlacement.
È possibile visualizzare sempre facendo clic su Barre degli strumenti scegliere dal menu di visualizzazione .
Può essere visualizzato utilizzando un controllo. VisibilityItem
Fornisce una barra degli strumenti associata a una finestra degli strumenti specifica, come una barra degli strumenti è associata all'ambiente di sviluppo.
Ignora il padre nella definizione.
Non può essere reso a un sottomenu di qualsiasi gruppo, neanche utilizzando CommandPlacement.
Viene visualizzata solo quando la finestra degli strumenti che ospita la barra degli strumenti visualizzazione e il package VS vengono aggiunti in modo esplicito la barra degli strumenti alla finestra degli strumenti. Questa operazione in genere viene eseguita quando la finestra degli strumenti viene creata recupero della proprietà dell'host della barra degli strumenti (come rappresentato dall'interfaccia di IVsToolWindowToolbarHost ) dalla cornice della finestra degli strumenti e chiamando quindi il metodo di AddToolbar .