Freigeben über


Gewusst wie: Hinzufügen von Befehlen zu Kontextmenüs

Dieses Thema veranschaulicht, wie einem Kontextmenü Befehle in einer Office-Anwendung hinzufügt, mit einem Add-In auf Anwendungsebene verwendet.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokument- und auf Anwendungsebene für Office 2013 und Office 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

Um Befehle Kontextmenüs in Office hinzufügen

  1. Fügen Sie ein Menüband-XML-Element einem Projekt auf Dokumentebene oder auf Anwendungsebene hinzu.Weitere Informationen finden Sie unter Gewusst wie: Erste Schritte beim Anpassen der Multifunktionsleiste.In

  2. Projektmappen-Explorer, wählen Sie ThisAddin.cs oder ThisAddin.vb.

  3. Klicken Sie auf der Menüleiste wählen Sie Ansicht, Code aus.

    Die ThisAddin-Klassendatei wird im Code-Editor geöffnet.

  4. Fügen Sie der ThisAddin-Klasse den folgenden Code hinzu:Mit diesem Code wird die CreateRibbonExtensibilityObject-Methode überschrieben und der Office-Anwendung die Menüband-XML-Klasse zurückgegeben.

    Protected Overrides Function CreateRibbonExtensibilityObject() As Microsoft.Office.Core.IRibbonExtensibility
        Return New Ribbon1()
    End Function
    
    protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject()
    {
          return new Ribbon1();
    }
    
  5. In Projektmappen-Explorer wählen Sie die Menüband-XML-Datei aus.Standardmäßig wird die Menüband-XML-Datei Ribbon1.xml benannt.

  6. Klicken Sie auf der Menüleiste wählen Sie Ansicht, Code aus.

    Die Menübandxml-datei wird im Code-Editor geöffnet.

  7. Fügen Sie im Code-Editor XML hinzu, das das Kontextmenü und das - Steuerelement beschrieben, die Sie dem Kontextmenü hinzufügen möchten.

    Im folgenden Beispiel wird eine Schaltfläche, ein Menü und ein Katalogsteuerelement Kontextmenü für ein Erstellen eines Word-Dokuments hinzu.Die Steuerelement-ID dieses Kontextmenüs ist ContextMenuText.Eine vollständige Liste der Office 2010-Verknüpfungssteuer-ID, finden Sie unter Office 2010-Hilfedateien: Benutzeroberflächen-Identitätskennzeichen Office fließende.

    <?xml version="1.0" encoding="UTF-8"?>
    <customUI xmlns="https://schemas.microsoft.com/office/2009/07/customui">
      <contextMenus>
        <contextMenu idMso="ContextMenuText">
          <button id="MyButton" label="My Button" insertBeforeMso="HyperlinkInsert" onAction="GetButtonID" />
          <menu id="MySubMenu" label="My Submenu" >
            <button id="MyButton2" label="Button on submenu" />
          </menu>
          <gallery id="galleryOne" label="My Gallery">
            <item id="item1" imageMso="HappyFace" />
            <item id="item2" imageMso="HappyFace" />
            <item id="item3" imageMso="HappyFace" />
            <item id="item4" imageMso="HappyFace" />
          </gallery>
        </contextMenu>
      </contextMenus>
    </customUI>
    
  8. In Projektmappen-Explorer wählen Sie MyRibbon.cs oder MyRibbon.vb aus.

  9. Fügen Sie die Rückrufmethode der Ribbon1-Klasse für jedes Steuerelement hinzu, das Sie behandeln möchten.

    Die folgenden Rückrufmethode behandelt die Schaltfläche Meine Schaltfläche.In diesem Code wird eine Zeichenfolge dem aktiven Dokument an der aktuellen Position des Cursor hinzu.

    Public Sub GetButtonID(ByVal control As Office.IRibbonControl)
        Dim currentRange As Word.Range = Globals.ThisAddIn.Application.Selection.Range
        currentRange.Text = "This text was added by the context menu named My Button."
    End Sub
    
    public void GetButtonID(Office.IRibbonControl control)
    {
        Microsoft.Office.Interop.Word.Range currentRange = Globals.ThisAddIn.Application.Selection.Range;
        currentRange.Text = "This text was added by the context menu named My Button.";
    }
    

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Erstellen von Kontextmenüs für Lesezeichen

Konzepte

Optionale Parameter in Office-Lösungen

Weitere Ressourcen

Anpassung der Office-Benutzeroberfläche

Anpassen von Kontextmenüs in Office 2010