Procedura: Creare barre degli strumenti per finestre degli strumenti

Articolo
05/17/2015

È possibile aggiungere una barra degli strumenti a una finestra degli strumenti definendo un menu di tipo ToolWindowToolbar in un file di package VS .vsct quindi programmare il pacchetto da visualizzare.

Le barre degli strumenti in finestre degli strumenti differiscono dalle barre degli strumenti dell'ambiente di sviluppo integrato generale (IDE) nei modi seguenti:

Una barra degli strumenti dell'IDE può essere creata solo definendo un menu di tipo Toolbar nel file di .vsct. Una barra degli strumenti della finestra degli strumenti deve a livello di codice sia creata nella finestra degli strumenti di destinazione.
Un utente può configurare una barra degli strumenti dell'IDE tramite la finestra di dialogo di personalizzare . Una barra degli strumenti della finestra degli strumenti non può essere configurata in questo modo.

Creare una barra degli strumenti della finestra degli strumenti

Una barra degli strumenti della finestra degli strumenti è innanzitutto definita come nel Elemento Menu file di .vsct.

Le procedure riportate di seguito si presuppone che si disponga di un progetto VSPackage in cui una finestra degli strumenti è definita nel file di .vsct. Se si crea un package VS, nella procedura guidata del pacchetto, in Finestra degli strumenti selezionato per aggiungere un file di .vsct al progetto del pacchetto e per definire una finestra degli strumenti.

Per creare una barra degli strumenti della finestra degli strumenti

Aprire il file di .vsct nell'editor.
Individuare la sezione che è tramite il Elemento Symbols.
Notare Elemento GuidSymbol che contiene i menu, gruppi e controlli. per impostazione predefinita, è denominato GUID <ProjectName> CmdSet.
Aggiungere Elemento IDSymbol alla barra degli strumenti e una per un gruppo di controlli, come illustrato nell'esempio seguente.
```
<IDSymbol name="TWToolbar" value="0x1000" />
<IDSymbol name="TWToolbarGroup" value="0x1050" />
```
Gli attributi di name degli elementi di IDSymbol e di GuidSymbol in una barra degli strumenti, in un comando, o un gruppo definito forniscono un GUID: Coppia di ID che rappresenta tale barra degli strumenti, comando, o gruppo. GUID rappresenta un comando impostato definito per il package VS. Imposta più di comando possono essere definiti nel pacchetto. Il GUID: La coppia ID utilizzata per identificare ogni elemento deve essere univoca.
Sopra la sezione che è tramite in Elemento Groups, creare una sezione tramite Elemento Menu.
Definire la barra degli strumenti come Elemento Menu elemento nella sezione di Menus , come segue:
1. Impostare gli attributi di id e di guid al GUID: ID della nuova barra degli strumenti.
2. Impostare l'attributo di type a ToolWindowToolbar.
3. Nell'elemento di Menu , utilizzare Elemento Strings per creare una sezione che contiene Elemento ButtonText un oggetto e un oggetto. Elemento CommandName L'elemento di ButtonText utilizzato per impostare il nome della barra degli strumenti visualizzato nell'IDE. L'elemento di CommandName utilizzato per impostare il nome del comando che può essere digitato nella finestra di commando per accedere alla barra degli strumenti.
Nell'esempio seguente viene definita una barra degli strumenti della finestra degli strumenti.
```
<Menu guid="guidTWToolbarCmdSet" id="TWToolbar" type="ToolWindowToolbar">
  <CommandFlag>DefaultDocked</CommandFlag>
  <Strings>
    <ButtonText>Test Toolbar</ButtonText>
    <CommandName>Test Toolbar</CommandName>
  </Strings>
</Menu>
```
In the Groups section, create a Elemento Group to contain the commands that you want to appear on your toolbar.
1. Impostare la priorità del gruppo per determinare dove verrà visualizzato nella barra degli strumenti.
  
  Un gruppo con un'impostazione con priorità bassa verrà visualizzato sul lato sinistro della barra degli strumenti (o superiore, in base alla barra degli strumenti è orientata).
2. Impostare l'elemento padre del gruppo al GUID: ID della barra degli strumenti.
Il seguente gruppo viene visualizzato nella barra degli strumenti definita nell'esempio precedente.
```
<Group guid="guidTWToolbarCmdSet" id="TWToolbarGroup" priority="0x0000">
  <Parent guid="guidTWToolbarCmdSet" id="TWToolbar" />
</Group>
```

Visualizzazione della barra degli strumenti della finestra degli strumenti

Utilizzare il pacchetto gestito Framework (MPF) per pianificare il pacchetto per visualizzare la barra degli strumenti della finestra degli strumenti.

La proprietà di ToolBar della classe di ToolWindowPane accetta un'istanza di CommandID come valore. L'istanza di CommandID accetta un oggetto (stringa) GUID e (int) un ID Impostando questi sul GUID: La coppia di ID della barra degli strumenti, la barra degli strumenti è associata alla finestra degli strumenti. In genere, questa operazione viene eseguita nel costruttore della classe che deriva dalla classe di ToolWindowPane .

Una finestra degli strumenti di codice gestito che viene compilata utilizzando il MPF può contenere solo una barra degli strumenti.

Per visualizzare la barra degli strumenti della finestra degli strumenti

Quando si crea un VSPackage tramite la procedura guidata del pacchetto, il comando GUID fissi viene aggiunta automaticamente alla classe di GuidList , definita nel file di Guids.cs. Il menu e gli ID di comando generati verranno aggiunti alla classe di PkgCmdIDList , definita in PkgCmdID.cs. Quindi, i valori ID e di GUID è possibile accedere, in un formato leggibile, tra queste due classi.

aprire PkgCmdID.cs.
Aggiungere una voce per la barra degli strumenti della finestra degli strumenti e per tutti i controlli che si desidera visualizzare nella barra degli strumenti. Il valore di ciascun elemento deve corrispondere all'attributo di value dell'elemento associato di IDSymbol .

Nell'esempio seguente viene creata una voce per il primo definito della barra degli strumenti.
```
public const int TWToolbar = 0x1000;
```
aprire MyToolWindow.cs.
Nel costruttore, impostare la proprietà di ToolBar della classe di MyToolWindow a una nuova istanza di CommandID con il GUID e l'ID della barra degli strumenti come parametri, come illustrato nell'esempio seguente.
```
this.ToolBar = new CommandID(
    GuidList.guidTWToolbarCmdSet,
    PkgCmdIDList.TWToolbar);
```
Se le classi di PkgCmdIDList e di GuidList non sono definite, è possibile utilizzare il valore di String il GUID e il valore di Int ID anziché.