Procedura: Creare barre degli strumenti nell'IDE

Articolo
05/17/2015

È possibile aggiungere una barra degli strumenti all'(IDE) ambiente di sviluppo integrato definendo un menu di tipo Toolbar in un file di package VS .vsct.

Una barra degli strumenti presenta le caratteristiche seguenti:

Una barra degli strumenti è una barra orizzontale o verticale che contiene i pulsanti. I pulsanti possono contenere un'icona o un testo, o una combinazione di icona e di testo.
Una barra degli strumenti può essere ancorata a tutto il bordo della finestra padre.
L'ide considera una barra degli strumenti VSPackage-contribuita appena vengono descritte le barre degli strumenti inclusi in Visual Studio. Il package VS non deve eseguire alcuna operazione a livello di codice per abilitare la barra degli strumenti venga riconosciuta dalla finestra di dialogo di personalizzare . Se un utente della barra degli strumenti, l'ide rileva automaticamente le modifiche.
L'ide automaticamente consente alla barra degli strumenti per visualizzare nel sottomenu di Barre degli strumenti del menu di visualizzazione in modo che sia possibile nasconderlo o visualizzare gli utenti.
Una pagina Opzioni strumenti implementata come finestra di dialogo, utilizzando un DialogProc per gestire i messaggi di windows, deve essere una finestra di dialogo non modale e non deve chiamare la funzione di EndDialog.

You can change these characteristics by specifying flags when you define the toolbar in the .vsct file, as shown in the following procedure.

Per creare una barra degli strumenti nell'IDE

Creare un pacchetto eseguendo il modello del pacchetto di Visual Studio. Seguire le istruzioni di pacchetto-creazione in procedura dettagliata: Aggiunta di una barra degli strumenti all'IDE.
Aprire il file di .vsct nell'editor. Nella sezione che è tramite la sezione di simboli , individuare l'elemento di GuidSymbol contenente i menu, gruppi e controlli.
Come illustrato nell'esempio seguente, aggiungere un elemento di IDSymbol per ognuno di questi: una barra degli strumenti, un gruppo di controlli e uno o più controlli.
```
<IDSymbol name="MyMenuGroup" value="0x1020" />
<IDSymbol name="cmdidTestCmd" value="0x0100" />
<IDSymbol name="Toolbar" value="0x1000" />
<IDSymbol name="ToolbarGroup" 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 il GUID: Coppia di ID che rappresenta tale barra degli strumenti, comando, o gruppo. Il 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 la sezione di gruppi , creare una sezione di menu .
Definire la barra degli strumenti come elemento di menu 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 priority (facoltativo).
  
  L'attributo di priority in genere viene omesso di una barra degli strumenti in quanto può essere spostato dagli utenti. L'omissione dell'attributo di priority ha lo stesso effetto ottenuto impostando la variabile a 0. Tuttavia, se la stessa finestra dispone di molte barre degli strumenti, è possibile assegnare le relative posizioni iniziali impostando le priorità.
3. Impostare l'attributo di type a Barra degli strumenti.
4. Nell'elemento di Menu , utilizzare l'elemento di stringhe per creare una sezione che contiene un elemento di ButtonText e un elemento di 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.
  
  Se si desidera aggiungere i flag di comando, aggiungere un elemento di CommandFlag per ciascuno.
  
  Per le descrizioni dei valori di flag di comando, vedere Elemento Command Flag.
Nell'esempio seguente viene definita una barra degli strumenti.
```
<Menu guid="guidIDEToolbarCmdSet" id="Toolbar"
      type="Toolbar" >
  <CommandFlag>DefaultDocked</CommandFlag>
  <Strings>
    <ButtonText>Test Toolbar</ButtonText>
    <CommandName>Test Toolbar</CommandName>
  </Strings>
</Menu>
```
Nota

Non è necessario definire un padre per un menu di tipo Toolbar perché viene inserito automaticamente nell'IDE.Qualsiasi impostazione del padre viene ignorata.
Nella sezione che è tramite la sezione di gruppi , creare un elemento di gruppo per contenere i controlli che si desidera visualizzare nella barra degli strumenti.
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.
```
<Group guid="guidIDEToolbarCmdSet" id="ToolbarGroup"
      priority="0x0000">
  <Parent guid="guidIDEToolbarCmdSet" id="Toolbar"/>
</Group>
```
Per aggiungere controlli alla barra degli strumenti creando le voci del comando nella sezione che è tramite la sezione di pulsanti . Impostare l'elemento padre di ogni voce command al GUID: ID del gruppo. Ogni elemento di pulsante deve essere un GUID: ID corrispondente a una voce nella sezione di Symbols .

Utilizzare l'attributo di priority di ogni voce del pulsante per specificare la posizione del comando viene visualizzato nel gruppo.

Nell'esempio seguente viene definito un pulsante che verrà visualizzato nella barra degli strumenti.
```
<Button guid="guidIDEToolbarCmdSet" id="cmdidTestCmd" priority="0x0100" type="Button">
  <Parent guid="guidIDEToolbarCmdSet" id="ToolbarGroup" />
  <Icon guid="guidImages" id="bmpPic1" />
  <Strings>
    <CommandName>cmdidTestCmd</CommandName>
    <ButtonText>Toolbar Test Command</ButtonText>
  </Strings>
</Button>
```
Per ulteriori informazioni sui pulsanti e le voci di menu, vedere Elemento Button.