procedura dettagliata: Aggiunta di un comando nella barra degli strumenti di Esplora soluzioni (c#)

Articolo
05/17/2015

In questa procedura dettagliata viene illustrato come aggiungere un pulsante nella barra degli strumenti di Visual StudioEsplora soluzioni .

Qualsiasi ordine, se in una barra degli strumenti o da un menu, vengono considerati un pulsante da Visual Studio. Quando si fa clic sul pulsante, il gestore comando viene eseguito. In genere, i controlli correlati vengono raggruppati formare un gruppo. I menu e barre degli strumenti fungono da contenitori per i gruppi. La priorità determina l'ordine in cui i singoli controlli in un gruppo appaiono nel menu o nella barra degli strumenti. È possibile impedire un pulsante da visualizzare nella barra degli strumenti o dal menu della visibilità. Un comando incluso in una sezione di <VisibilityConstraints> del file di .vsct viene visualizzato solo nel contesto associato. La visibilità non può essere applicato ai gruppi.

Per ulteriori informazioni sui menu, i controlli barra degli strumenti e i file di .vsct, vedere Controlli, menu e barre degli strumenti.

Nota

File della Tabella dei comandi di utilizzo XML (.vsct) anziché file di configurazione della tabella al comando (.ctc) per definire come i menu e i controlli nel package VS.Per ulteriori informazioni, vedere Tabella dei comandi di Visual Studio (. file di Vsct).

Prerequisiti

Per eseguire questa procedura dettagliata, è necessario installare Visual Studio SDK.

Nota

Per ulteriori informazioni su Visual Studio SDK, vedere Cenni preliminari sull'estensione di Visual Studio.Per ulteriori informazioni su come scaricare Visual Studio SDK, vedere Centro per sviluppatori di estensibilità di Visual Studio sul sito Web MSDN.

Posizioni del modello di progetto del pacchetto Visual Studio

Il modello di progetto del pacchetto Visual Studio è disponibile in tre percorsi nella finestra di dialogo di nuovo progetto :

In Estensibilità di Visual Basic. La lingua predefinita del progetto di Visual Basic.
In Estensibilità di C#. La lingua predefinita del progetto è c#.
In L'altra estensibilità dei tipi di progetto. La lingua predefinita del progetto è C++.

Questa sezione della procedura dettagliata viene illustrato come utilizzare il modello di progetto importa pacchetto di Visual Studio per creare un package VS che supporta un comando di menu.

Per creare il SolutionToolbar VSPackage

Creare un package VS denominato SolutionToolbar. Per ulteriori informazioni, vedere procedura dettagliata: Creazione di un comando di menu utilizzando il modello importa pacchetto Visual Studio.
Impostare il linguaggio di programmazione a Visual C#, comando di menuselezionato, impostare il nome del comando a Pulsante della barra degli strumentiComando di teste impostare l'ID di comando a cmdidTestCmd.

Aggiunta di un pulsante nella barra degli strumenti di Esplora soluzioni

Questa sezione della procedura dettagliata viene descritto come aggiungere un pulsante nella barra degli strumenti di Esplora soluzioni . Quando si fa clic sul pulsante, il codice nel metodo di callback viene eseguito.

Per aggiungere un pulsante nella barra degli strumenti di Esplora soluzioni

In Esplora soluzioni, fare doppio clic su SolutionToolbar.vsct per aprirlo in un editor di testo.
Nella sezione di <Symbols> , il nodo di <GuidSymbol>il cui nome termina in “CmdSet„ contiene il gruppo di menu e comandi che è stato generato dal modello del pacchetto. Aggiungere un elemento di <IDSymbol> in questo nodo per dichiarare il gruppo che si utilizzerà il comando.
```
<IDSymbol name="SolutionToolbarGroup" value="0x0190"/>
```
Nella sezione di <Groups> , dopo la voce del gruppo esistente, definire il nuovo gruppo dichiarate nel passaggio precedente.
```
<Group guid="guidSolutionToolbarCmdSet"
       id="SolutionToolbarGroup" priority="0xF000">
  <Parent guid="guidSHLMainMenu" id="IDM_VS_TOOL_PROJWIN"/>
</Group>
```
Impostare il GUID padre: la coppia di identificazione a guidSHLMainMenu e a IDM_VS_TOOL_PROJWIN inserisce il gruppo della barra degli strumenti di Esplora soluzioni e l'impostazione di un valore con inserirlo dopo gli altri gruppi di controlli.

Nella sezione di <Buttons> , modificare il padre ID voce generata di <Button> per riflettere il gruppo di cui è definito nel passaggio precedente. L'elemento modificato di <Button> dovrebbe essere simile al seguente markup.

<Button guid="guidSolutionToolbarCmdSet" id="cmdidTestCmd" priority="0x0100" type="Button">
  <Parent guid="guidSolutionToolbarCmdSet" id="SolutionToolbarGroup" />
  <Icon guid="guidImages" id="bmpPic1" />
  <Strings>
    <CommandName>cmdidTestCmd</CommandName>
    <ButtonText>Toolbar Button Test Command</ButtonText>
  </Strings>
</Button>

Compilare la soluzione e verificare la presenza di errori.
Premere F5 per aprire la compilazione sperimentale di Visual Studio in una seconda finestra.

La barra degli strumenti di Esplora soluzioni verrà visualizzato il nuovo pulsante di comando a destra dei pulsanti esistenti. L'icona del pulsante è il numero 1 in un quadrato.
Fare clic sul nuovo pulsante.

Una finestra di dialogo con il messaggio “, interno Microsoft.SolutionToolbar.SolutionToolbarPackage.MenuItemCallback()„ deve essere visualizzato.

Controllo della visibilità di un pulsante

Questa sezione della procedura dettagliata viene descritto come controllare la visibilità di un pulsante di una barra degli strumenti. Impostando un contesto a uno o più progetti nella sezione di <VisibilityConstraints> del file di SolutionToolbar.vsct, limitate un pulsante per essere visualizzato solo quando un progetto o i progetti vengono aperti.

Per visualizzare un pulsante a uno o più progetti vengono aperti

Se non è già stato chiuso la compilazione sperimentale di Visual Studio , ora chiuderlo.
Nella sezione di <Buttons> di SolutionToolbar.vsct, aggiungere due flag del comando all'elemento esistente di <Button> , tra <Strings> i tag di <Icons> .
```
<CommandFlag>DefaultInvisible</CommandFlag>
<CommandFlag>DynamicVisibility</CommandFlag>
```
I flag diDynamicVisibility e di DefaultInvisibledevono essere impostati in modo che sia possibile rendere effettive le voci nella sezione di <VisibilityConstraints> .
Creare una sezione di <VisibilityConstraints> che dispone di due voci di <VisibilityItem> . Inserire la nuova sezione immediatamente dopo il tag di chiusura di </Commands> .
```
<VisibilityConstraints>
  <VisibilityItem guid="guidSolutionToolbarCmdSet"
        id="cmdidTestCmd"
        context="UICONTEXT_SolutionHasSingleProject" />
  <VisibilityItem guid="guidSolutionToolbarCmdSet"
        id="cmdidTestCmd"
        context="UICONTEXT_SolutionHasMultipleProjects" />
</VisibilityConstraints>
```
Ogni elemento di visibilità rappresenta una condizione che il pulsante specificato. Per applicare più condizioni, è necessario creare più voci per lo stesso pulsante.
Scegliere Ricompila soluzione dal menu Compila. È necessario ricompilare la soluzione per verificare la modifica di menu.
Premere F5 per aprire la compilazione sperimentale di Visual Studio .

La barra degli strumenti di Esplora soluzioni non contiene il pulsante che abbia il 1. numerico con.
Aprire una soluzione contenente un progetto o i progetti multipli.

Il pulsante che presenta il numero 1 viene visualizzato nella barra degli strumenti a destra dei pulsanti esistenti.
Scegliere Chiudi soluzione dal menu File. Il pulsante viene rimosso dalla barra degli strumenti.

La visibilità del pulsante è controllata da Visual Studio fino a caricare il package VS. Dopo che il package VS viene caricato, la visibilità del pulsante viene controllata dal package VS. Per ulteriori informazioni, vedere Procedura: Creare e gestire i comandi in Vspackage (c#).

Vedere anche

Altre risorse

Controlli, menu e barre degli strumenti

Procedure dettagliate per i controlli, i menu e le barre degli strumenti

Condividi tramite