Gewusst wie: Ändern des Standardsymbols für ein Add-In

Sie können das Symbol ändern, das dem Menübefehl für ein Add-In zugeordnet ist, das Sie anhand des Add-In-Projekttyps von Visual Studio erstellt haben. Um den Add-In-Projekttyp zu suchen, erweitern Sie im Dialogfeld Neues Projekt den Eintrag Andere Projekttypen, und klicken Sie dann auf Erweiterungsprojekte.

Wenn Sie ein Add-In unter Verwendung des Add-In-Projekttyps erstellen, können Sie im Add-In-Assistenten eine Benutzeroberfläche für das Add-In erstellen, indem Sie das Kontrollkästchen Soll eine Befehlszeilen-Benutzeroberfläche für das Add-In erstellt werden? aktivieren.

Mit der Vorlage wird im Menü Extras ein Befehl zum Öffnen des Add-Ins erstellt. Standardmäßig befindet sich neben dem Befehl ein Smileysymbol. Sie können das Symbol mit einer der folgenden Methoden ändern:

• Ändern Sie in der Microsoft.VisualStudio.CommandBars-Assembly die Indexnummer des Symbols (59 für das Standardsymbol) in die Nummer eines anderen Symbols. Die Assembly enthält fast 3.000 Symbole.

• Definieren Sie eine benutzerdefinierte Bitmap, beispielsweise ein Unternehmenslogo, kompilieren Sie sie in einer Satelliten-DLL als Ressource, und ändern Sie dann den Add-In-Code, damit er auf die neue Bitmap verweist.

Die erste Methode ist schneller, Sie können jedoch nur die Symbole in Microsoft.VisualStudio.CommandBars verwenden. Mit der zweiten Methode können Sie ein beliebiges Symbol verwenden.

So ändern Sie das aktuelle Symbol in ein anderes Symbol

1. Öffnen Sie eine Projektmappe, die mit dem Add-In-Projekttyp erstellt wurde.

2. Suchen Sie in der Projektdatei in der OnConnection-Methode die folgende Zeile.

   command = commands.AddNamedCommand2(_addInInstance, _
     "MyAddin1", "MyAddin1",  _
     "Executes the command for MyAddin1", True, 59, Nothing, _
     CType(vsCommandStatus.vsCommandStatusSupported, _
      Integer) + 
      CType(vsCommandStatus.vsCommandStatusEnabled, _
      Integer), vsCommandStyle.vsCommandStylePictAndText, _
      vsCommandControlType.vsCommandControlTypeButton)
   

   Command command = commands.AddNamedCommand2(_addInInstance, 
   "MyAddin1", "MyAddin1", "Executes the command for MyAddin1", 
   true, 59, ref contextGUIDS, (int)vsCommandStatus.
   vsCommandStatusSupported+(int)vsCommandStatus.
   vsCommandStatusEnabled, (int)vsCommandStyle.
   vsCommandStylePictAndText, vsCommandControlType
   .vsCommandControlTypeButton);
   

   Im AddNamedCommand2-Aufruf wird die Zahl 59 angezeigt. Dies ist der Index des aktuellen Symbols. Um ein anderes Standardsymbol zu verwenden, ändern Sie diese Zahl. Ändern Sie z. B. 59 in 6743, um das Symbol in einen roten Stern zu ändern. Wenn Sie das Add-In ausführen, wird der Befehl im Menü Extras zusammen mit einem roten Sternsymbol angezeigt.

   Informationen zum Suchen der ID-Nummern für Standardsymbole finden Sie auf der MSDN-Website unter Listing Button Faces in the Command Bar for the Microsoft Office System.

3. Wenn Sie in der Microsoft.VisualStudio.CommandBars- Bibliothek kein geeignetes Symbol finden, können Sie eine benutzerdefinierte Bitmap verwenden. Kompilieren Sie die Bitmap in einer Satelliten-DLL als Ressource. Weitere Informationen finden Sie unter Gewusst wie: Anzeigen eines benutzerdefinierten Symbols auf der Schaltfläche für das Add-In. Nachdem Sie die Satelliten-DLL-Ressource erstellt haben, verweisen Sie in AddNamedCommand2 auf diese Ressource.

Siehe auch

Aufgaben

Gewusst wie: Steuern von Add-Ins mit dem Add-In-Manager

Gewusst wie: Erstellen von Add-Ins

Exemplarische Vorgehensweise: Erstellen eines Assistenten

Referenz

Visual Studio-Befehle und -Schalter

Konzepte

Add-In-Registrierung

Diagramm "Automationsobjektmodell"

Weitere Ressourcen

Erstellen von Add-Ins und Assistenten