Gewusst wie: Erstellen von Symbolleisten in der IDE erstellt

Artikel
05/16/2015

Sie können eine Symbolleiste der integrierten Entwicklungsumgebung (IDE), indem Sie ein Menü des Typs Toolbar in einer Datei hinzufügen .vsct VSPackages definieren.

Eine Symbolleiste verfügt über die folgenden Eigenschaften:

Eine Symbolleiste stellt einen horizontalen oder ein senkrechter Strich, die Schaltflächen enthält. Diese Schaltflächen können ein Symbol oder einen Text oder eine Kombination des Symbols und des Texts haben.
Eine Symbolleiste kann auf jeden Rand des übergeordneten Fensters angeordnet werden.
Die IDE behandelt eine VSPackage-beigetragene Symbolleiste so wie sie behandelt Symbolleisten, die in Visual Studio enthalten sind. VSPackage muss keine programmgesteuert tun, um das Dialogfeld Anpassen erkannt werden, die Symbolleiste zu aktivieren. Wenn ein Benutzer die Symbolleiste anzupassen, verfolgt die IDE automatisch die Änderungen nach.
Die IDE aktiviert automatisch die Symbolleiste, um auf dem Symbolleisten Untermenü des Ansicht Menüs angezeigt werden, sodass Benutzer sie ausblenden oder anzeigen können.
Eine Symbolleiste, die keinen sichtbaren Befehl verfügt, wird automatisch ausgeblendet.

Sie können diese Eigenschaften mit Flags, wenn Sie die Symbolleiste in der .vsct-Datei festlegen, wie in der folgenden Prozedur gezeigt ändern angeben.

So erstellen Sie eine Symbolleiste in der IDE

Erstellen Sie ein Paket, indem Sie die Visual Studio-Paket-Vorlage ausführen. Folgen Sie den Anweisungen in Exemplarische Vorgehensweise: Eine Symbolleiste hinzufügen in der IDEBuild Paket.
Öffnen Sie die .vsct-Datei im Editor. Im Abschnitt, der vom Symbole-Abschnitt formatiert ist, suchen Sie das GuidSymbol-Element, das die Menüs, Gruppen und Befehle enthält.
Wie im folgenden Beispiel gezeigt ein IDSymbol-Element für jedes dieser Elemente hinzu: eine Symbolleiste, eine Befehlsgruppe und einen oder mehrere Befehle.
```
<IDSymbol name="MyMenuGroup" value="0x1020" />
<IDSymbol name="cmdidTestCmd" value="0x0100" />
<IDSymbol name="Toolbar" value="0x1000" />
<IDSymbol name="ToolbarGroup" value="0x1050" />
```
Die name-Attribute der GuidSymbol und IDSymbol-Elemente in einer definierten Symbolleiste in einem Befehl oder einer Gruppe stellen die GUID: ID-Paar, das diese Symbolleiste, Befehls- oder Gruppe darstellt. Die GUID stellt ein Befehl dar, der für ein VSPackage definiert ist. Mehrere Befehls legt werden im Paket definiert werden. Die GUID: ID-Paare, die verwendet wird, um die einzelnen Elemente zu identifizieren, müssen eindeutig sein.
Derzeit in dem Abschnitt, der vom Gruppen-Abschnitt formatiert ist, erstellen Sie einen Menüs-Abschnitt.
Definieren Sie die Symbolleiste als Menüs-Element im Menus-Abschnitt wie folgt:
1. Legen Sie die guid und id-Attribute in den GUID fest: ID der neuen Symbolleiste.
2. Legen Sie das priority-Attribut fest (optional).
  
  Das priority-Attribut wird i. d. R. für eine Symbolleiste ausgelassen, da es möglicherweise von den Benutzern verschoben wird. Das Weglassen des Attributs priority hat dieselben Auswirkungen wie das Festlegen 0werden. Wenn jedoch das gleiche Fenster einige Symbolleisten verfügt, können Sie deren Startpositionen zuweisen, indem Sie die Prioritäten festgelegt werden.
3. Legen Sie das Attribut auf Symbolleistetype fest.
4. Im Menu-Element Zeichenfolgen verwenden Sie das Element, um einen Abschnitt zu erstellen, der ein ButtonText-Element und ein CommandName-Element enthält. Das ButtonText-Element wird verwendet, um den Namen der Symbolleiste festlegen, wie sie in der IDE angezeigt wird. Das CommandName-Element wird verwendet, um den Befehlsnamen festzulegen, der im Fenster Befehl eingegeben werden kann, um die Symbolleiste zuzugreifen.
  
  Wenn Sie die Spaltenflags hinzufügen möchten, fügen Sie ein CommandFlag für jedes Element hinzu.
  
  Die Beschreibungen der Befehl Flags werten finden Sie unter Command Flag-Element.
Im folgenden Beispiel wird eine Symbolleiste.
```
<Menu guid="guidIDEToolbarCmdSet" id="Toolbar"
      type="Toolbar" >
  <CommandFlag>DefaultDocked</CommandFlag>
  <Strings>
    <ButtonText>Test Toolbar</ButtonText>
    <CommandName>Test Toolbar</CommandName>
  </Strings>
</Menu>
```
Hinweis

Sie müssen ein übergeordnetes Element für ein Menü des Typs Toolbar definieren, da sie automatisch in die IDE angeordnet wird.Jede Einstellung für übergeordnetes Element wird ignoriert.
Im Abschnitt, der vom Gruppen-Abschnitt formatiert ist, erstellen Sie ein Gruppe-Element, um die Befehle enthalten soll, dass Sie auf der Symbolleiste angezeigt werden sollen.
1. Legen Sie die Priorität der Gruppe fest, um zu bestimmen, wo sie auf der Symbolleiste angezeigt wird.
  
  Eine Gruppe, die eine Einstellung der Basispriorität verfügt, wird links neben der Symbolleiste (oder der Anfang, je nachdem, wie die Symbolleiste sind).
2. Legen Sie das übergeordnete Element der Gruppe der GUID fest: ID der Symbolleiste.
Die folgende Gruppe wird auf der Symbolleiste.
```
<Group guid="guidIDEToolbarCmdSet" id="ToolbarGroup"
      priority="0x0000">
  <Parent guid="guidIDEToolbarCmdSet" id="Toolbar"/>
</Group>
```
Fügen Sie der Symbolleiste Befehle hinzu, indem Sie Befehls Dateisystemeinträgen im Abschnitt erstellen, der vom Schaltflächen-Abschnitt formatiert ist. Legen Sie das übergeordnete Element für jedes Befehls Zieleintrags dem GUID fest: ID der Gruppe. Jedes Element muss ein Schaltfläche GUID aufweisen: ID, die einem Eintrag im Symbols-Abschnitt entspricht.

Verwenden Sie das Attribut priority einzelnen Schaltflächen Zieleintrags, um anzugeben, an welcher Stelle der Befehl in der Gruppe angezeigt wird.

Im folgenden Beispiel wird eine Schaltfläche auf der Symbolleiste angezeigt wird.
```
<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>
```
Weitere Informationen über Schaltflächen und Menüelementen finden Sie unter Button-Element.