Freigeben über


Gewusst wie: Fügen Sie Symbole in Symbolleisten Befehle hinzu

Befehle können in Menüs und Symbolleisten angezeigt werden. Klicken Sie auf Symbolleisten ist es üblich, damit ein Befehl mit nur einem Symbol angezeigt werden kann (Leerzeichen speichern), während in Menüs ein Befehl in der Regel mit einem Symbol und Text angezeigt wird.

Symbole sind 16 Pixel breit und 16 Pixel hoch und können entweder 8-Bit-Farbtiefe (256 Farben oder True Color 32-Bit-Farbtiefe ()) sein. 32-Bit-Farben Symbole sind. d. R. bevorzugt wird. Symbole werden in der Regel in einer horizontalen Zeile in einer einzigen Bitmap angeordnet, obwohl mehrere Bitmaps zulässig sind. Diese Bitmap wird in der .vsct-Datei zusammen mit den einzelnen Symbolen deklariert, die in der Bitmap zur Verfügung stehen. Weitere Informationen finden Sie unter Bitmaps-Element für den Verweis.

Ein Symbol an einen Befehl hinzu

So fügen Sie einem Befehl ein Symbol hinzu

  1. Erstellen Sie eine Bitmap mit einer Farbtiefe 32-Bit-Version. Ein Symbol ist immer 16 x 16. Daher muss diese Bitmap 16 Pixel hoch und ein Vielfaches von 16 Pixel breit sein.

    Jedes Symbol wird auf die Bitmap neben einander in einer einzelnen Zeile platziert. Verwenden Sie den Alphakanal, um Speicherorte der Transparenz in einem Symbol anzugeben.

    Wenn Sie eine 8-Bit-Farbtiefe, verwenden magenta, RGB(255,0,255)verwenden, während die Transparenz. 32-Bit-Farben sind jedoch Symbole. d. R. bevorzugt wird.

  2. Öffnen Sie die .vsct-Datei im Editor.

  3. In Symbols-Elementfinden Sie unter GuidSymbol-Element , das die vorhandenen Einträge für Bitmap enthält. Standardmäßig ist dies guidImagesbenannt.

    Im folgenden Beispiel wird das standardmäßige <GuidSymbol>-Element an, das von der Visual Studio-Paket-Vorlage generiert wird.

    <GuidSymbol name="guidImages" value="{7f2b0178-a581-424f-933f-f6da41774269}">
      <IDSymbol name="bmpPic1" value="1" />
      <IDSymbol name="bmpPic2" value="2" />
      <IDSymbol name="bmpPicSearch" value="3" />
      <IDSymbol name="bmpPicX" value="4" />
      <IDSymbol name="bmpPicArrows" value="5" />
    </GuidSymbol>
    
  4. Fügen Sie für jedes Symbol IDSymbol-Element in der Bitmap. Das Attribut ist name die ID des Symbols, und value gibt ihre Position im Streifen an.

  5. Erstellen Sie im Bitmap-Element<Bitmaps>-Abschnitt der .vsct-Datei, um die Bitmap dargestellt, die die Symbole enthält.

    • Legen Sie den guid-Wert des Attributs auf den Namen des <GuidSymbol>-Elements fest, das die Bitmapdatei Deklarationen enthält.

    • Legen Sie das href-Attribut auf den relativen Pfad der Bitmapdatei fest, oder legen Sie das resID-Attribut auf eine Ressource Satz von ganzzahligen Wert fest, das im Paket an anderer Stelle die gewünschten Bitmap verweist.

    • Sie können die Leistung verbessern, indem Sie das Attribut auf einen usedList durch Trennzeichen getrennte Liste der in einem VSPackage festlegen, Symbole, die verwendet werden soll. Symbole nicht in der Liste enthalten sind, ausgeschlossene Formular Batchkompilierung. Sie müssen ein usedList angeben, wenn Sie ein resID anstelle eines href verwenden.

    Das folgende Beispiel zeigt den Eintrag an, der von der Vorlage erstellten Pakets.

    <Bitmap guid="guidImages" href="Resources\Images_32bit.bmp" usedList="bmpPic1, bmpPic2, bmpPicSearch, bmpPicX, bmpPicArrows" />
    
  6. Erstellen Sie Button-Element in Buttons-Element oder verwenden Sie einen vorhandenen Eintrag.

    • Innerhalb des Elements <Button> Fügen Sie Icon-Element hinzu, und legen Sie dessen guid und id-Attribute die GUID fest: ID eines der Symbole in der Bitmap.

    • Wenn gewünscht werden, fügen Sie eines der folgenden Flags als Command Flag-ElementDefinition der Schaltflächen hinzu:

      IconAndText: Das Symbol und der Schaltflächentext im Menü und klicken Sie auf der Symbolleiste angezeigt.

      Pict: Nur das Symbol des Befehls wird auf einer Symbolleiste angezeigt, wenn nur der Text des Befehls in einem Menü angezeigt wird. Wenn ein Symbol nicht angegeben wird, wird ein leerer Bereich auf einer Symbolleiste angezeigt.

      TextOnly: Es wird nur der Text des Befehls einem Menü oder auf einer Symbolleiste angezeigt. Das <Icon>-Element wird ignoriert.

      Weitere Informationen über Befehls Flags finden Sie in der <CommandFlag> Dokumentation zur Element.

Siehe auch

Konzepte

VSCT-XML-Schemaverweis

Weitere Ressourcen

Allgemeine Aufgaben mit Befehlen, Menüs und Symbolleisten