Freigeben über


Exemplarische Vorgehensweise: Erstellen einer benutzerdefinierten Registerkarte mithilfe von Menüband-XML

In dieser exemplarischen Vorgehensweise wird das Erstellen einer benutzerdefinierten Menübandregisterkarte mithilfe des Menübandelements (XML) veranschaulicht.

Gilt für: Die Informationen in diesem Thema gelten für Projekte auf Dokumentebene und VSTO-Add-In-Projekte für die folgenden Anwendungen: Excel; InfoPath 2013 und InfoPath 2010; Outlook; Powerpoint; Projekt; Visio; Wort. Weitere Informationen finden Sie unter features available by Office-App lication and project type.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

  • Hinzufügen von Schaltflächen zur Registerkarte "Add-Ins ". Die Registerkarte "Add-Ins" ist die Standardregisterkarte, die in der XML-Datei des Menübands definiert ist.

  • Automatisieren von Microsoft Office Word mithilfe der Schaltflächen auf der Registerkarte "Add-Ins ".

Hinweis

Auf Ihrem Computer werden möglicherweise andere Namen oder Speicherorte für die Benutzeroberflächenelemente von Visual Studio angezeigt als die in den folgenden Anweisungen aufgeführten. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Personalisieren von Visual Studio-IDE.

Voraussetzungen

Zum Abschließen dieser exemplarischen Vorgehensweise benötigen Sie Folgendes:

Erstellen des Projekts

Der erste Schritt besteht im Erstellen eines VSTO-Add-In-Projekts für Word. Sie passen später die Registerkarte "Add-Ins" dieses Dokuments an.

So erstellen Sie ein neues Projekt

  1. Erstellen Sie ein Word-Add-In-Projekt mit dem Namen MyRibbonAddIn.

    Weitere Informationen finden Sie unter How to: Create Office projects in Visual Studio.

    Visual Studio öffnet die Codedatei ThisAddIn.cs oder ThisAddIn.vb und fügt das MyRibbonAddIn-Projekt zu Projektmappen-Explorer hinzu.

Erstellen der Registerkarte "VSTO-Add-Ins"

Um die Registerkarte "Add-Ins " zu erstellen, fügen Sie Ihrem Projekt ein Menübandelement (XML) hinzu. Später in dieser exemplarischen Vorgehensweise werden Sie dieser Registerkarte einige Schaltflächen hinzufügen.

So erstellen Sie die Registerkarte "Add-Ins"

  1. Klicken Sie im Menü Projekt auf Neues Element hinzufügen.

  2. Wählen Sie im Dialogfeld "Neues Element hinzufügen" die Option "Menüband (XML)" aus.

  3. Ändern Sie den Namen des neuen Menübands in MyRibbon, und klicken Sie dann auf Hinzufügen.

    Die Datei "MyRibbon.cs " oder "MyRibbon.vb " wird im Designer geöffnet. Eine XML-Datei mit dem Namen "MyRibbon.xml " wird ebenfalls zu Ihrem Projekt hinzugefügt.

  4. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf "ThisAddin.cs" oder "ThisAddin.vb", und klicken Sie dann auf "Code anzeigen".

  5. 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 MyRibbon();
    }
    
  6. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf das MyRibbonAddIn-Projekt, und klicken Sie dann auf "Erstellen". Vergewissern Sie sich, dass das Projekt ohne Fehler erstellt wurde.

Hinzufügen von Schaltflächen zur Registerkarte "Add-Ins"

Das Ziel dieses VSTO-Add-Ins besteht darin, Benutzern eine Möglichkeit bereitzustellen, dem aktiven Dokument Textbausteine und eine bestimmte Tabelle hinzuzufügen. Um die Benutzeroberfläche bereitzustellen, fügen Sie der Registerkarte "Add-Ins" zwei Schaltflächen hinzu, indem Sie die XML-Datei des Menübands ändern. Später in dieser exemplarischen Vorgehensweise definieren Sie Rückrufmethoden für die Schaltflächen. Weitere Informationen zur XML-Datei des Menübands finden Sie unter Menüband-XML.

So fügen Sie der Registerkarte "Add-Ins" Schaltflächen hinzu

  1. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf MyRibbon.xml, und klicken Sie dann auf "Öffnen".

  2. Ersetzen Sie den Inhalt des Registerkartenelements durch den folgenden XML-Code. Dieser XML-Code ändert die Beschriftung der Standardsteuerelementgruppe in "Inhalt" und fügt zwei neue Schaltflächen mit den Bezeichnungen "Text einfügen" und "Tabelle einfügen" hinzu.

    <tab idMso="TabAddIns">
        <group id="ContentGroup" label="Content">
            <button id="textButton" label="Insert Text"
                 screentip="Text" onAction="OnTextButton"
                 supertip="Inserts text at the cursor location."/>
            <button id="tableButton" label="Insert Table"
                 screentip="Table" onAction="OnTableButton"
                 supertip="Inserts a table at the cursor location."/>
        </group>
    </tab>
    

Automatisieren des Dokuments mithilfe der Schaltflächen

Sie müssen Rückrufmethoden für die Schaltflächen "Text einfügen" und "Tabelle einfügen" hinzufügenonAction, um Aktionen auszuführen, wenn der Benutzer darauf klickt. Weitere Informationen zu Rückrufmethoden für Menübandsteuerelemente finden Sie unter Menüband-XML.

So fügen Sie Rückrufmethoden für die Schaltflächen hinzu

  1. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf "MyRibbon.cs" oder "MyRibbon.vb", und klicken Sie dann auf "Öffnen".

  2. Fügen Sie oben in der Datei "MyRibbon.cs " oder "MyRibbon.vb " den folgenden Code hinzu. Dieser Code erstellt einen Alias für den Namespace Microsoft.Office.Interop.Word.

    using Word = Microsoft.Office.Interop.Word;
    
  3. Fügen Sie der MyRibbon-Klasse die folgende Methode hinzu. Dies ist eine Rückrufmethode für die Schaltfläche "Text einfügen", die dem aktiven Dokument an der aktuellen Position des Cursors eine Zeichenfolge hinzufügt.

    public void OnTextButton(Office.IRibbonControl control)
    {
        Word.Range currentRange = Globals.ThisAddIn.Application.Selection.Range;
        currentRange.Text = "This text was added by the Ribbon.";
    }
    
  4. Fügen Sie der MyRibbon-Klasse die folgende Methode hinzu. Dies ist eine Rückrufmethode für die Schaltfläche "Tabelle einfügen", die dem aktiven Dokument an der aktuellen Position des Cursors eine Tabelle hinzufügt.

    public void OnTableButton(Office.IRibbonControl control)
    {
        object missing = System.Type.Missing;
        Word.Range currentRange = Globals.ThisAddIn.Application.Selection.Range;
        Word.Table newTable = Globals.ThisAddIn.Application.ActiveDocument.Tables.Add(
        currentRange, 3, 4, ref missing, ref missing);
    
        // Get all of the borders except for the diagonal borders.
        Word.Border[] borders = new Word.Border[6];
        borders[0] = newTable.Borders[Word.WdBorderType.wdBorderLeft];
        borders[1] = newTable.Borders[Word.WdBorderType.wdBorderRight];
        borders[2] = newTable.Borders[Word.WdBorderType.wdBorderTop];
        borders[3] = newTable.Borders[Word.WdBorderType.wdBorderBottom];
        borders[4] = newTable.Borders[Word.WdBorderType.wdBorderHorizontal];
        borders[5] = newTable.Borders[Word.WdBorderType.wdBorderVertical];
    
        // Format each of the borders.
        foreach (Word.Border border in borders)
        {
            border.LineStyle = Word.WdLineStyle.wdLineStyleSingle;
            border.Color = Word.WdColor.wdColorBlue;
        }
    }
    

Testen des VSTO-Add-Ins

Wenn Sie das Projekt ausführen, wird Word geöffnet, und die Registerkarte mit dem Namen "Add-Ins" wird im Menüband angezeigt. Klicken Sie auf der Registerkarte "Add-Ins" auf die Schaltflächen "Text einfügen" und "Tabelle einfügen", um den Code zu testen.

So testen Sie Ihr VSTO-Add-In

  1. Drücken Sie F5, um das Projekt auszuführen.

  2. Vergewissern Sie sich, dass die Registerkarte "Add-Ins " im Menüband angezeigt wird.

  3. Klicken Sie auf die Registerkarte Add-Ins .

  4. Vergewissern Sie sich, dass die Inhaltsgruppe im Menüband sichtbar ist.

  5. Klicken Sie in der Gruppe "Inhalt" auf die Schaltfläche "Text einfügen".

    Eine Zeichenfolge wird dem Dokument an der aktuellen Position des Cursors hinzugefügt.

  6. Klicken Sie in der Inhaltsgruppe auf die Schaltfläche "Tabelle einfügen".

    Eine Tabelle wird dem Dokument an der aktuellen Position des Cursors hinzugefügt.

Nächste Schritte

Weitere Informationen zum Anpassen der Office-Benutzeroberfläche finden Sie in diesen Themen:

  • Passen Sie das Menüband einer anderen Office-App lizenzierung an. Weitere Informationen zu den Anwendungen, die das Anpassen des Menübands unterstützen, finden Sie in der Menübandübersicht.

  • Passen Sie das Menüband einer Office-App lizenzierung mithilfe des Menüband-Designers an. Weitere Informationen finden Sie unter Ribbon Designer.

  • Erstellen eines benutzerdefinierten Aktionsbereichs. Weitere Informationen finden Sie im Übersichtsbereich "Aktionen".

  • Anpassen der Benutzeroberfläche von Microsoft Office Outlook mithilfe von Outlook-Formularbereichen. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Entwerfen eines Outlook-Formularbereichs.