Hinzufügen von Symbolen zu Menübefehlen

  • Artikel

Befehle können sowohl in Menüs als auch auf Symbolleisten angezeigt werden. Auf Symbolleisten ist es üblich, dass ein Befehl nur mit einem Symbol (zum Sparen von Platz) angezeigt wird, während in Menüs ein Befehl in der Regel sowohl mit einem Symbol als auch mit Text angezeigt wird.

Symbole sind 16 Pixel breit und 16 Pixel hoch und können entweder 8-Bit-Farbtiefe (256 Farben) oder 32-Bit-Farbtiefe (echte Farbe) sein. 32-Bit-Farbsymbole werden bevorzugt. Symbole werden in der Regel in einer einzelnen horizontalen Zeile in einer einzelnen 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 verfügbar sind. Weitere Details finden Sie in der Referenz für das Bitmaps-Element .

Hinzufügen eines Symbols zu einem Befehl

Im folgenden Verfahren wird davon ausgegangen, dass Sie über ein vorhandenes VSPackage-Projekt mit einem Menübefehl verfügen. Informationen dazu finden Sie unter Erstellen einer Erweiterung mit einem Menübefehl.

  1. Erstellen Sie eine Bitmap mit einer Farbtiefe von 32 Bits. Ein Symbol ist immer 16 x 16, sodass diese Bitmap 16 Pixel hoch und ein Vielfaches von 16 Pixel breit sein muss.

    Jedes Symbol wird auf der Bitmap nebeneinander in einer einzelnen Zeile platziert. Verwenden Sie den Alphakanal, um Transparenzstellen in den einzelnen Symbolen anzuzeigen.

    Wenn Sie eine 8-Bit-Farbtiefe verwenden, verwenden Sie Magenta, RGB(255,0,255)als Transparenz. 32-Bit-Farbsymbole werden jedoch bevorzugt.

  2. Kopieren Sie die Symboldatei in das Ressourcenverzeichnis in Ihrem VSPackage-Projekt. Fügen Sie im Projektmappen-Explorer das Symbol zum Projekt hinzu. (Wählen Sie Ressourcen, und klicken Sie im Kontextmenü auf "Hinzufügen", dann auf "Vorhandenes Element", und wählen Sie ihre Symboldatei aus.)

  3. Öffnen Sie die VSCT-Datei im Editor.

  4. Fügen Sie ein GuidSymbol Element mit dem Namen "testIcon" hinzu. Erstellen Sie eine GUID (Tools>Erstellen einer GUID, wählen Sie dann Registrierungsformat aus, und klicken Sie auf Kopieren), und fügen Sie sie in das value Attribut ein. Das Ergebnis sollte wie folgt aussehen:

    <!-- Create your own GUID -->
<GuidSymbol name="testIcon" value="{00000000-0000-0000-0000-0000}">

  5. Fügen Sie ein <IDSymbol> Symbol hinzu. Das name Attribut ist die ID des Symbols und gibt value die Position auf dem Streifen an, falls vorhanden. Wenn nur ein Symbol vorhanden ist, fügen Sie 1 hinzu. Das Ergebnis sollte wie folgt aussehen:

    <!-- Create your own GUID -->
<GuidSymbol name="testIcon" value="{00000000-0000-0000-0000-0000}">
    <IDSymbol name="testIcon1" value="1" />
</GuidSymbol>

  6. Erstellen Sie einen <Bitmap> im <Bitmaps> Abschnitt innerhalb <Commands> des Abschnitts der VSCT-Datei , um die Bitmap mit den Symbolen darzustellen.

    • Legen Sie den guid Wert auf den Namen des Elements fest, das <GuidSymbol> Sie im vorherigen Schritt erstellt haben.

    • Legen Sie den href Wert auf den relativen Pfad der Bitmapdatei fest (in diesem Fall "Resources\<icon"-Dateiname>.

    • Legen Sie den usedList Wert auf das zuvor erstellte IDSymbol fest. Dieses Attribut gibt eine durch Trennzeichen getrennte Liste der Symbole an, die im VSPackage verwendet werden sollen. Symbole, die nicht in der Liste enthalten sind, sind ausgeschlossene Formularkompilierung.

      Der Bitmapblock sollte wie folgt aussehen:

      <Bitmap guid="testIcon" href="Resources\<icon file name>" usedList="testIcon1"/>

  7. Legen Sie im vorhandenen <Button> Element das Icon Element auf die zuvor erstellten GUIDSymbol- und IDSymbol-Werte fest. Hier ist ein Beispiel für ein Button-Element mit diesen Werten:

    <Button guid="guidAddIconCmdSet" id="cmdidMyCommand" priority="0x0100" type="Button">
    <Parent guid="guidAddIconCmdSet" id="MyMenuGroup" />
    <Icon guid="testIcon" id="testIcon1" />
    <Strings>
        <ButtonText>My Command name</ButtonText>
    </Strings>
</Button>

  8. Testen Sie Ihr Symbol. Erstellen Sie das Projekt, und starten Sie das Debugging. Suchen Sie in der experimentellen Instanz den Befehl. Es sollte das hinzugefügte Symbol angezeigt werden.

Zugehöriger Inhalt