procedura dettagliata: Aggiunta di una barra degli strumenti a una finestra degli strumenti

Articolo
05/17/2015

In questa procedura dettagliata viene illustrato come aggiungere una barra degli strumenti a una finestra degli strumenti. Le barre degli strumenti consentono di accedere rapidamente ai controlli nella finestra degli strumenti.

Una barra degli strumenti è un oggetto orizzontale o la banda verticale che contiene i pulsanti associati ai controlli. La lunghezza di una barra degli strumenti in una finestra degli strumenti è sempre la stessa larghezza o dell'altezza della finestra degli strumenti, a seconda della barra degli strumenti è ancorata.

Le barre degli strumenti in finestre degli strumenti non vengono create automaticamente dall'ambiente (IDE) di sviluppo integrato. È necessario aggiungere a livello di codice dal package VS che crea la finestra degli strumenti.

A differenza delle barre degli strumenti nell'IDE, una barra degli strumenti in una finestra degli strumenti deve essere ancorata e non può essere spostata o personalizzata. Se la finestra degli strumenti VSPackage è scritta in codice gestito, la barra degli strumenti è ancorata sempre sul bordo superiore della finestra. Tuttavia, se il package VS è scritto in codice umanaged, la barra degli strumenti può essere ancorata a tutto il bordo.

Per ulteriori informazioni su come aggiungere una barra degli strumenti dell'IDE, vedere procedura dettagliata: Aggiunta di una barra degli strumenti all'IDE.

Prerequisiti

Per completare questa procedura dettagliata, è necessario installare Visual Studio 2010 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 il 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++.

Creare un package VS per una finestra degli strumenti

In questa sezione viene illustrato come utilizzare il modello di progetto importa pacchetto di Visual Studio per creare una finestra degli strumenti package VS che supporta solo un comando di menu.

Per creare il TWToolbar VSPackage

Creare un package VS denominato la TWBarra degli strumenti. 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 Basic o a **Visual C#**e selezionare comando di menu e le opzioni di Finestra degli strumenti .
In ordinare le opzioni, impostare il nome del comando a comando di TWTeste l'ID di comando a cmdidTWTestCmd.
In Opzioni della finestra degli strumenti, impostare il nome della finestra viene Finestra strumento di teste l'ID di comando a cmdidTestTool.

Creare una barra degli strumenti per una finestra degli strumenti

Per creare una barra degli strumenti della finestra degli strumenti

Aprire TWToolbar.vsct nell'editor di testo.
Nella sezione di Symbols , nel nodo di GuidSymbol denominato “guidTWToolbarCmdSet„, dichiarare una barra degli strumenti e un gruppo della barra degli strumenti, come segue.
```
<IDSymbol name="TWToolbar" value="0x1000" />
<IDSymbol name="TWToolbarGroup" value="0x1050" />
```
Nella parte superiore della sezione di Commands , creare una sezione di Menus .
```
<Menus></Menus>
```
La definizione della barra degli strumenti si trova in questo caso perché il parser di VSCT non fa distinzione tra i menu e le barre degli strumenti a questo livello.
Aggiungere un elemento di Menu alla sezione di Menus per definire la barra degli strumenti.
```
<Menu guid="guidTWToolbarCmdSet" id="TWToolbar" type="ToolWindowToolbar">
  <CommandFlag>DefaultDocked</CommandFlag>
  <Strings>
    <ButtonText>Test Toolbar</ButtonText>
    <CommandName>Test Toolbar</CommandName>
  </Strings>
</Menu>
```
Le barre degli strumenti non possono essere annidate come sottomenu. Di conseguenza, non è necessario assegnare un elemento padre. Inoltre, non è necessario stabilire una priorità, perché è possibile spostare barre degli strumenti. In genere, la posizione iniziale di una barra degli strumenti è definita a livello di codice, ma le successive modifiche dall'utente vengono salvate in modo permanente.

Nella sezione di Groups , dopo la voce del gruppo esistente, definire un gruppo per contenere i controlli per la barra degli strumenti.

<Group guid="guidTWToolbarCmdSet" id="TWToolbarGroup" priority="0x0000">
  <Parent guid="guidTWToolbarCmdSet" id="TWToolbar" />
</Group>

Nella sezione di Buttons , modificare l'elemento padre dell'elemento esistente di Button al gruppo della barra degli strumenti in modo che verrà visualizzata la barra degli strumenti.
```
<Button guid="guidTWToolbarCmdSet" id="cmdidTWTestCommand" priority="0x0100" type="Button">
  <Parent guid="guidTWToolbarCmdSet" id="TWToolbarGroup" />
  <Icon guid="guidImages" id="bmpPic1" />
  <Strings>
    <CommandName>cmdidTWTestCmd</CommandName>
    <ButtonText>TWTest Command</ButtonText>
  </Strings>
</Button>
```
Per impostazione predefinita, se una barra degli strumenti non presenta comandi, non viene visualizzato.

Poiché la nuova barra degli strumenti non viene aggiunto automaticamente alla finestra degli strumenti dall' IDE di Visual Studio, la barra degli strumenti deve essere aggiunti a livello di codice dal package VS stessa. Ciò viene discusso nella sezione successiva, “aggiunta di una barra degli strumenti alla finestra degli strumenti.„

Aggiungendo la barra degli strumenti alla finestra degli strumenti

Per aggiungere la barra degli strumenti alla finestra degli strumenti

Nel progetto TWToolbar, aprire PkgCmdID.vb o PkgCmdID.cs nell'editor di testo.
Dopo che gli ID di comandi esistenti nel PkgCmdID file, aggiungere la seguente identificazione di comando
```
public const int TWToolbar = 0x1000;
```
Aprire MyToolWindow.vb o MyToolWindow.cs nell'editor di testo.
All'inizio del file, dopo gli altri Imports o istruzioni di using , aggiungere la seguente riga.
```
using System.ComponentModel.Design; // for CommandID
```
Nel costruttore della classe di MyToolWindow , all'inizio del costruttore, aggiungere la seguente riga.
```
this.ToolBar = new CommandID(
    GuidList.guidTWToolbarCmdSet,
    PkgCmdIDList.TWToolbar);
```
Questo codice indica al framework (MPF) gestito del pacchetto della barra degli strumenti per creare quando la finestra degli strumenti viene creata.

Nota

Nel codice gestito, solo una barra degli strumenti può essere aggiunto a una finestra degli strumenti.
Scegliere Compila soluzione dal menu Compila per compilare la soluzione.

Test della barra degli strumenti della finestra degli strumenti

Per testare la barra degli strumenti della finestra degli strumenti

Premere F5 per aprire un'istanza di Visual Studio sperimentale in modalità di debug.
Scegliere dal menu di visualizzazione , il punto a altre finestre quindi fare clic su Finestra strumento di test per visualizzare la finestra degli strumenti.

Si noti che una barra degli strumenti viene visualizzata sotto il titolo della finestra degli strumenti.
Nella barra degli strumenti della finestra degli strumenti, fare clic sull'icona per visualizzare il messaggio “Company.TWToolbar.TW interno ToolbarPackage.MenuItemCallback()„.

Vedere anche

Attività

procedura dettagliata: Aggiunta di una barra degli strumenti all'IDE

Altre risorse

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

Controlli, menu e barre degli strumenti

Condividi tramite