Exemplarische Vorgehensweise: Eine Symbolleiste hinzufügen in der IDE

Artikel
05/16/2015

In dieser exemplarischen Vorgehensweise wird erläutert, wie eine Symbolleiste der Visual Studio integrierten Entwicklungsumgebung (IDE) hinzugefügt wird.

Eine Symbolleiste ist ein horizontaler oder vertikaler Streifen, der Schaltflächen enthält, die an Befehle gebunden sind. Abhängig von der Implementierung kann eine Symbolleiste in der IDE auf jeder Seite des Fensters der main IDE neu angeordnet werden angedockt sind, oder hergestellt werden, um vor anderen Fenstern bleibt.

Darüber hinaus können Benutzer auf einer Symbolleiste Befehle hinzufügen oder diese daraus entfernen, indem Sie das Dialogfeld Anpassen verwenden. In der Regel sind Symbolleisten in VSPackages anpassbar. Die IDE behandelt alle Anpassungen, und VSPackages reagiert auf Befehle. VSPackage muss nicht wissen, wo ein Befehl physisch gespeichert ist.

Weitere Informationen über Menüs finden Sie unter Befehle, Menüs und Symbolleisten.

Vorbereitungsmaßnahmen

Zum Abschließen dieser exemplarischen Vorgehensweise müssen Sie Visual Studio 2010 SDKinstallieren.

Hinweis

Weitere Informationen über das Visual Studio-SDK finden Sie unter Erweitern von Visual Studio Overview.Um herauszufinden finden Sie unter wie das Visual Studio-SDK, auf Visual Studio Extensibility Developer Center der MSDN-Website herunterlädt.

Speicherorte für die Visual Studio-Paket-Projektvorlage

Die Visual Studio-Paket Projektvorlage ist in drei Positionen im Dialogfeld Neues Projekt verfügbar:

Die Visual Basic-Erweiterbarkeit. Die Standardsprache des Projekts ist Visual Basic.
Die C#-Erweiterbarkeit. Die Standardsprache ist C# des Projekts.
Die Andere Projekttypen/Erweiterungen. Die Standardsprache des Projekts ist C++.

Erstellen einer Symbolleiste für ein VSPackage

In diesem Abschnitt wird die Verwendung der Visual Studio-Paket Projektvorlage verwendet, um VSPackages zu erstellen, die eine Symbolleiste unterstützt, die derzeit einen Menübefehl hat.

So erstellen Sie die Symbolleiste VSPackage

Erstellen Sie ein VSPackage, das IDEToolbarbenannt ist. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Wenn Sie einen Menübefehl mit der Visual Studio-Paket-Vorlage erstellen.
In der Visual Studio-Paket Vorlage legen Sie die Programmiersprache Visual Basic fest, oder Visual C#, legen Sie die Option Menübefehlden Befehlsnamen zu SymbolleistefestTest-Befehlund für die Befehls-ID an cmdidTestCmdfest.

Eine Symbolleiste für die IDE erstellen

So erstellen Sie eine Symbolleiste für die IDE

Öffnen Sie IDEToolbar.vsct im Text-Editor.
Klicken Sie im Abschnitt Symbole GuidSymbol-Element mit dem Namen „guidIDEToolbarCmdSet“ fügen Sie eine Symbolleiste und Deklarationen für eine Gruppe von Symbolleisten wie folgt hinzu.
```
<IDSymbol name="Toolbar" value="0x1000" />
<IDSymbol name="ToolbarGroup" value="0x1050" />
```
Klicken Sie am oberen Rand des Befehle-Abschnitt erstellen Sie einen Menüs-Abschnitt.
```
<Menus></Menus>
```
Die Definition der Symbolleiste wird hier nicht lokalisiert, da der VSCT-Parser zwischen Menüs und Symbolleisten auf dieser Ebene unterschieden wird.
Fügen Sie ein Menüs-Element dem Menus-Abschnitt hinzu, um die Symbolleiste zu definieren.
```
<Menu guid="guidIDEToolbarCmdSet" id="Toolbar"
      type="Toolbar" >
  <CommandFlag>DefaultDocked</CommandFlag>
  <Strings>
    <ButtonText>Test Toolbar</ButtonText>
    <CommandName>Test Toolbar</CommandName>
  </Strings>
</Menu>
```
Symbolleisten können nicht wie Untermenüs geschachtelt werden. Deshalb müssen Sie eine übergeordnete Gruppe nicht zuweisen. Sie müssen außerdem eine Priorität nicht festlegen, da der Benutzer Symbolleisten verschieben kann. In der Regel wird das ursprüngliche Position einer Symbolleiste programmgesteuert definiert, aber nachfolgende Änderungen durch den Benutzer werden beibehalten.
Im Abschnitt Gruppen nach dem Eintrag in einer vorhandenen Gruppe, definieren Sie ein Gruppe-Element, um die Befehle für die Symbolleiste integriert werden.
```
<Group guid="guidIDEToolbarCmdSet" id="ToolbarGroup"
      priority="0x0000">
  <Parent guid="guidIDEToolbarCmdSet" id="Toolbar"/>
</Group>
```
Im Schaltflächen-Abschnitt ändern Sie das übergeordnete Element des vorhandenen Elements Schaltfläche Gruppe Symbolleisten, damit die Symbolleiste angezeigt wird.
```
<Parent guid="guidIDEToolbarCmdSet" id="ToolbarGroup" />
```
Wenn eine Symbolleiste keine Befehle verfügt, wird sie nicht.
Klicken Sie im Menü Erstellen auf Projektmappe erstellen. Beheben Sie alle Fehler, die auftreten können.
Drücken Sie F5, um die experimentelle Visual Studio im Debugmodus zu öffnen.
Klicken Sie mit der rechten Maustaste auf die IDE-Menüleiste, und klicken Sie dann auf Symbolleiste testen in der Liste Symbolleisten.
Wenn Sie auf das Symbol auf der neuen Symbolleiste klicken, sollte die Meldung „innerhalb Company.Toolbar.ToolbarPackage.MenuItemCallback()“ angezeigt werden.

Siehe auch

Weitere Ressourcen

Exemplarische Vorgehensweisen für Befehle, Menüs und Symbolleisten

Befehle, Menüs und Symbolleisten

Freigeben über