Freigeben über

Schritt-für-Schritt-Anleitung: Erstellen einer benutzerdefinierten Registerkarte mithilfe von Menüband-XML

In diesem Tutorial wird das Erstellen einer benutzerdefinierten Menübandregisterkarte mithilfe des Ribbon-Elements (XML) veranschaulicht.

Gilt für: Die Informationen in diesem Thema gelten für Dokumentprojekte und VSTO-Add-In-Projekte für die folgenden Anwendungen: Excel; InfoPath 2013 und InfoPath 2010; Outlook; PowerPoint; Project; Visio; Word. Weitere Informationen finden Sie unter Funktionen verfügbar nach Office-Anwendung und Projekttyp.

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

Sie benötigen die folgenden Komponenten, um diese Schritt-für-Schritt-Anleitung abzuschließen.

Erstelle das Projekt

Der erste Schritt besteht darin, ein Word VSTO-Add-In-Projekt zu erstellen. 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 ThisAddIn.cs - oder ThisAddIn.vb-Codedatei und fügt das MyRibbonAddIn-Projekt dem 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 Anleitung fügen Sie dieser Registerkarte einige Schaltflächen hinzu.

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 auf "Hinzufügen".

    Die MyRibbon.cs - oder MyRibbon.vb-Datei wird im Designer geöffnet. Außerdem wird ihrem Projekt eine XML-Datei mit dem Namen MyRibbon.xml hinzugefügt.

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

  5. Fügen Sie der ThisAddin-Klasse den folgenden Code hinzu. Dieser Code setzt die CreateRibbonExtensibilityObject Methode außer Kraft und gibt die Menüband-XML-Klasse an die Office-Anwendung zurück.

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

  6. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das MyRibbonAddIn-Projekt , und klicken Sie dann auf "Erstellen". Stellen Sie sicher, dass das Projekt ohne Fehler erstellt wird.

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

Ziel dieses VSTO-Add-Ins ist es, Benutzern eine Möglichkeit zum Hinzufügen von Textbausteinen und einer bestimmten Tabelle zum aktiven Dokument zu geben. 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 Anleitung definieren Sie Callback-Methoden 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 im Projektmappen-Explorer mit der rechten Maustaste auf MyRibbon.xml , und klicken Sie dann auf "Öffnen".

  2. Ersetzen Sie den Inhalt des Tabs durch das folgende XML-Dokument. 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 "onAction und "Tabelle einfügen" hinzufügen, 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 im Projektmappen-Explorer mit der rechten Maustaste auf MyRibbon.cs oder MyRibbon.vb, und klicken Sie dann auf "Öffnen".

  2. Fügen Sie den folgenden Code am Anfang der datei MyRibbon.cs oder MyRibbon.vb hinzu. Dieser Code erstellt einen Alias für den Microsoft.Office.Interop.Word Namespace.

    using Word = Microsoft.Office.Interop.Word;

  3. Füge 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üge 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 Ihr 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".

    An der aktuellen Position des Cursors wird dem Dokument eine Zeichenfolge hinzugefügt.

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

    An der aktuellen Position des Cursors wird dem Dokument eine Tabelle hinzugefügt.

Nächste Schritte

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

Verwandte Inhalte

  • Last updated on