Exemplarische Vorgehensweise: Erstellen einer benutzerdefinierten Registerkarte mithilfe des Menüband-Designers

Artikel
10/10/2023

Mit dem Menüband-Designer können Steuerelemente auf der benutzerdefinierten Registerkarte hinzugefügt und positioniert werden.

Gilt für: Die Informationen in diesem Thema gelten für Projekte auf Dokumentebene für Excel. Weitere Informationen finden Sie unter features available by Office-App lication and project type.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

Erstellen von Aktionsbereichen.
Erstellen Sie eine benutzerdefinierte Registerkarte.
Ausblenden und Anzeigen von Aktionsbereichen mithilfe von Schaltflächen auf der benutzerdefinierten Registerkarte

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:

Eine Edition von Visual Studio, die die Microsoft Office-Entwicklungstools umfasst. Weitere Informationen finden Sie unter Konfigurieren eines Computers zum Entwickeln von Office-Lösungen.
Microsoft Excel

Erstellen eines Excel-Arbeitsmappenprojekts

Die Schritte für die Verwendung des Menüband-Designers sind für alle Office-Anwendungen nahezu identisch. In diesem Beispiel wird eine Excel-Arbeitsmappe verwendet.

So erstellen Sie ein Excel-Arbeitsmappenprojekt

Erstellen Sie ein Excel-Arbeitsmappenprojekt mit dem Namen MyExcelRibbon. Weitere Informationen finden Sie unter How to: Create Office Projects in Visual Studio.

Visual Studio öffnet die neue Arbeitsmappe im Designer und fügt das MyExcelRibbon-Projekt zu Projektmappen-Explorer hinzu.

Erstellen von Aktionsbereichen

Fügen Sie dem Projekt zwei benutzerdefinierte Aktionsbereiche hinzu. Später werden der benutzerdefinierten Registerkarte Schaltflächen hinzugefügt, mit denen diese Aktionsbereiche angezeigt und ausgeblendet werden.

So erstellen Sie Aktionsbereiche

Klicken Sie im Menü Projekt auf Neues Element hinzufügen.
Wählen Sie im Dialogfeld "Neues Element hinzufügen" die Option "ActionsPaneControl" und dann " Hinzufügen" aus.

Die Datei ActionsPaneControl1.cs oder ActionsPaneControl1.vb wird im Designer geöffnet.
Fügen Sie auf der Registerkarte "Allgemeine Steuerelemente " der Toolbox der Designeroberfläche eine Beschriftung hinzu.
Legen Sie im Eigenschaftenfenster die Texteigenschaft "label1" auf "Aktionsbereich 1" fest.
Wiederholen Sie die Schritte 1 bis 5, um einen zweiten Aktionsbereich und eine Bezeichnung zu erstellen. Legen Sie die Text-Eigenschaft der zweiten Bezeichnung auf Aktionsbereich 2 fest.

Erstellen einer benutzerdefinierten Registerkarte

Eine der Entwurfsrichtlinien für Office-Anwendungen besagt, dass Benutzer immer die Möglichkeit haben sollen, die Benutzeroberfläche von Office-Anwendungen zu steuern. Um diese Funktion für die Aktionsbereiche hinzuzufügen, können Schaltflächen hinzugefügt werden, mit denen jeder Aktionsbereich von einer benutzerdefinierten Registerkarte auf dem Menüband angezeigt und ausgeblendet werden kann. Um eine benutzerdefinierte Registerkarte zu erstellen, fügen Sie dem Projekt ein Menübandelement (Visual Designer) hinzu. Der Designer unterstützt Sie beim Hinzufügen und Anordnen von Steuerelementen, Festlegen von Steuerelementeigenschaften und Behandeln von Ereignissen von Steuerelementen.

So erstellen Sie eine benutzerdefinierte Registerkarte

Klicken Sie im Menü Projekt auf Neues Element hinzufügen.
Wählen Sie im Dialogfeld Neues Element hinzufügen die Option Menüband (Visueller Designer)aus.
Ändern Sie den Namen des neuen Menübands in MyRibbon, und wählen Sie "Hinzufügen" aus.

Die Datei MyRibbon.cs oder MyRibbon.vb wird im Menüband-Designer geöffnet. Sie beinhaltet eine standardmäßige Registerkarte und eine Gruppe.
Wählen Sie im Menüband-Designer die Standardregisterkarte aus.
Erweitern Sie im Eigenschaftenfenster die ControlId-Eigenschaft, und legen Sie dann die ControlIdType-Eigenschaft auf "Benutzerdefiniert" fest.
Legen Sie die Bezeichnungseigenschaft auf "Meine benutzerdefinierte Registerkarte" fest.
Wählen Sie im Menüband-Designer "Gruppe1" aus.
Legen Sie im Eigenschaftenfenster "Bezeichnung" den Aktionsbereich-Manager fest.
Ziehen Sie auf der Registerkarte "Steuerelemente des Office-Menübands " der Toolbox eine Schaltfläche auf "Gruppe1".
Schaltfläche1 auswählen.
Legen Sie im Eigenschaftenfenster "Bezeichnung" den Bereich "Aktionen anzeigen" 1 fest.
Fügen Sie der Gruppe1 eine zweite Schaltfläche hinzu, und legen Sie die Bezeichnungseigenschaft auf "Aktionen anzeigen" 2 fest.
Ziehen Sie auf der Registerkarte "Office-Menübandsteuerelemente " der Toolbox ein ToggleButton-Steuerelement auf Gruppe1.
Legen Sie die Bezeichnungseigenschaft auf "Aktionen ausblenden" fest.

Ausblenden und Anzeigen von Aktionsbereichen mithilfe von Schaltflächen auf der benutzerdefinierten Registerkarte

Im letzten Schritt wird Code hinzugefügt, der auf den Benutzer reagiert. Fügen Sie Ereignishandler für die Click-Ereignisse der zwei Schaltflächen und das Click-Ereignis der Umschaltfläche hinzu. Fügen Sie diesen Ereignishandlern Code hinzu, um das Aus- und Einblenden der Aktionsbereiche zu aktivieren.

So werden Aktionsbereiche mithilfe von Schaltflächen auf der benutzerdefinierten Registerkarte ausgeblendet und angezeigt

Öffnen Sie in Projektmappen-Explorer das Kontextmenü für MyRibbon.cs oder MyRibbon.vb, und wählen Sie dann "Code anzeigen" aus.

Fügen Sie oben in der MyRibbon-Klasse den folgenden Code hinzu: Mit diesem Code werden zwei Aktionsbereichobjekte erstellt.

ActionsPaneControl1 actionsPane1 = new ActionsPaneControl1();
ActionsPaneControl2 actionsPane2 = new ActionsPaneControl2();

Dim actionsPane1 As New ActionsPaneControl1()
Dim actionsPane2 As New ActionsPaneControl2()

Ersetzen Sie die MyRibbon_Load-Methode durch den folgenden Code. Mit diesem Code werden die Aktionsbereichsobjekte der Controls-Auflistung hinzugefügt und die Objekte ausgeblendet. Durch den Visual C#-Code werden außerdem Delegate an mehrere Menüband-Steuerelementereignisse angefügt.

private void MyRibbon_Load(object sender, RibbonUIEventArgs e)
{
    Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane1);
    Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane2);
    actionsPane1.Hide();
    actionsPane2.Hide();
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = false;

    this.button1.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
        this.button1_Click);
    this.button2.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
        this.button2_Click);
    this.toggleButton1.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
        this.toggleButton1_Click);


}

Private Sub MyRibbon_Load(ByVal sender As System.Object, ByVal e As Microsoft.Office.Tools.Ribbon.RibbonUIEventArgs) Handles MyBase.Load
    Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane1)
    Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane2)
    actionsPane1.Hide()
    actionsPane2.Hide()
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = False
End Sub

Fügen Sie der MyRibbon-Klasse die folgenden drei Ereignishandlermethoden hinzu. Diese Methoden dienen zur Behandlung der Click-Ereignisse der zwei Schaltflächen und des Click-Ereignisses der Umschaltfläche. Die Ereignishandler für button1 und button2 zeigen andere Aktionsbereiche an. Der Ereignishandler für toggleButton1 zeigt den aktiven Aktionsbereich an und blendet diesen aus.

private void button1_Click(object sender, RibbonControlEventArgs e)
{
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
    actionsPane2.Hide();
    actionsPane1.Show();
    toggleButton1.Checked = false;
}

private void button2_Click(object sender, RibbonControlEventArgs e)
{
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
    actionsPane1.Hide();
    actionsPane2.Show();
    toggleButton1.Checked = false;

}

private void toggleButton1_Click(object sender, RibbonControlEventArgs e)
{
    if (toggleButton1.Checked == true)
    {
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = false;
    }
    else
    {
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
    }

}

Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) _
        Handles Button1.Click
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = True
    actionsPane2.Hide()
    actionsPane1.Show()
    ToggleButton1.Checked = False
End Sub

Private Sub Button2_Click(ByVal sender As System.Object, _
    ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) _
        Handles Button2.Click

    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = True
    actionsPane1.Hide()
    actionsPane2.Show()
    ToggleButton1.Checked = False

End Sub


Private Sub ToggleButton1_Click(ByVal sender As System.Object, _
    ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) _
        Handles ToggleButton1.Click

    If ToggleButton1.Checked Then
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = False
    Else
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = True
    End If

End Sub

Testen der benutzerdefinierten Registerkarte

Wenn Sie das Projekt ausführen, wird Excel gestartet, und die Registerkarte "Meine benutzerdefinierte Registerkarte" wird im Menüband angezeigt. Wählen Sie die Schaltflächen auf " Meine benutzerdefinierte Registerkarte " aus, um die Aktionsbereiche ein- und auszublenden.

So testen Sie die benutzerdefinierte Registerkarte

Drücken Sie F5, um das Projekt auszuführen.
Wählen Sie die Registerkarte "Meine benutzerdefinierte Registerkarte" aus.
Wählen Sie in der Gruppe "Benutzerdefinierter Aktionsbereich-Manager " die Option "Aktionenbereich 1 anzeigen" aus.

Der Aktionsbereich wird angezeigt und zeigt den Bezeichnungsbereich "Aktionen" 1 an.
Wählen Sie " Aktionsbereich 2 anzeigen" aus.

Der Aktionsbereich wird angezeigt und zeigt den Bezeichnungsbereich "Aktionen" 2 an.
Wählen Sie " Aktionsbereich ausblenden" aus.

Die Aktionsbereiche werden nicht mehr angezeigt.

Nächste Schritte

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

Fügen Sie jeder Anpassung auf Dokumentebene kontextbasierte Benutzeroberfläche hinzu. Weitere Informationen finden Sie im Übersichtsbereich "Aktionen".
Erweitern Sie ein standardmäßiges oder benutzerdefiniertes Microsoft Office Outlook-Formular. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Entwerfen eines Outlook-Formularbereichs.