Freigeben über

Hinzufügen von Befehlen zu Kontextmenüs

  • Artikel

In diesem Thema wird gezeigt, wie Sie mithilfe eines VSTO-Add-Ins Befehle zu einem Kontextmenü in einer Office-Anwendung hinzufügen.

Gilt für: Die Informationen in diesem Thema gelten für Projekte auf Dokumentebene und VSTO-Add-In-Projekte. Siehe Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

So fügen Sie in Office einem Kontextmenü Befehle hinzu

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

  2. Projektmappen-Explorerwählen Sie ThisAddIn.cs oder ThisAddIn.vbaus.

  3. Wählen Sie in der Menüleiste Ansicht>Code aus.

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

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

    protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject()
{
      return new Ribbon1();
}

  5. Wählen Sie die Menüband-XML-Datei im Projektmappen-Exploreraus. Standardmäßig erhält die Menüband-XML-Datei den Namen Ribbon1.xml.

  6. Wählen Sie in der Menüleiste Ansicht>Code aus.

    Die Menüband-XML-Datei wird im Code-Editor geöffnet.

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

    Im folgenden Beispiel werden dem Kontextmenü für ein Word-Dokument ein Schaltflächen-, ein Menü- und ein Katalog-Steuerelement hinzugefügt. Die Steuerelement-ID dieses Kontextmenüs lautet „ContextMenuText“. Eine vollständige Liste der Steuerelement-IDs für Office 2010-Kontextmenüs finden Sie unter Office 2010-Hilfedateien: Steuerelementbezeichner der Office Fluent-Benutzeroberfläche.

    <?xml version="1.0" encoding="UTF-8"?>
<customUI xmlns="http://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. Wählen Sie im Projektmappen-Explorerdie Datei MyRibbon.cs oder MyRibbon.vbaus.

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

    Die folgende Rückrufmethode verarbeitet die Schaltfläche My Button . Dieser Code fügt dem aktiven Dokument an der aktuellen Position des Cursors eine Zeichenfolge hinzu.

    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.";
}

Zugehöriger Inhalt