Zugreifen auf das Menüband zur Laufzeit

  • Artikel

Sie können Code zum Einblenden, Ausblenden und Ändern des Menübands schreiben und Benutzern das Ausführen des Codes von Steuerelementen in einem benutzerdefinierten Aufgabenbereich, Aktionsbereich oder Outlook-Formularbereich ermöglichen.

Sie können mit der Globals-Klasse auf das Menüband zugreifen. Bei Outlook-Projekten können Sie auf die Menübänder zugreifen, die in einem bestimmten Outlook-Inspektor- oder Outlook-Explorer-Fenster angezeigt werden.

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.

Zugreifen auf das Menüband mithilfe der Globals-Klasse

Sie können die Globals-Klasse verwenden, um von einer beliebigen Stelle im Projekt auf das Menüband in einem Projekt auf Dokumentebene oder in einem VSTO-Add-In-Projekt zuzugreifen.

Weitere Informationen zur Globals Klasse finden Sie unter globalen Zugriff auf Objekte in Office-Projekten.

Im folgenden Beispiel wird dieGlobals-Klasse für den Zugriff auf ein benutzerdefiniertes Menüband mit der Bezeichnung Ribbon1 und zum Festlegen des Texts verwendet, der in einem Kombinationsfeld im Menüband für Hello World angezeigt wird.

private void Access_All_Ribbons_Globals()
{
    Globals.Ribbons.Ribbon1.comboBox1.Text = "Hello World";
}

Zugreifen auf eine Sammlung von Menübändern, die in einem bestimmten Outlook-Inspektorfenster angezeigt werden

Sie können auf eine Sammlung von Menübändern zugreifen, die in Outlook-Inspektoren angezeigt werden. Ein Inspektor ist ein Fenster, das in Outlook geöffnet wird, wenn Benutzer bestimmte Aufgaben ausführen, z. B. E-Mails verfassen. Um auf das Menüband eines Inspektor-Fensters zuzugreifen, rufen Sie die Ribbons-Eigenschaft der Globals-Klasse auf und übergeben ein Inspector-Objekt, das den Inspektor darstellt.

Im folgenden Beispiel wird die Menübandauflistung des Inspektors abgerufen, der gerade den Fokus besitzt. In diesem Beispiel wird dann auf ein Menüband mit der Bezeichnung Ribbon1 zugegriffen und der Text festgelegt, der in einem Kombinationsfeld im Menüband für Hello World angezeigt wird.

private void Access_Ribbons_By_Inspector()
{
    ThisRibbonCollection ribbonCollection = 
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveInspector()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}

Zugreifen auf eine Sammlung von Menübändern, die für einen bestimmten Outlook-Explorer angezeigt werden

Sie können auf eine Sammlung von Menübändern zugreifen, die in einem Outlook-Explorer angezeigt werden. Ein Explorer ist die Haupt-Benutzeroberfläche (UI) der Anwendung für eine Instanz von Outlook. Um auf das Menüband eines Explorer-Fensters zuzugreifen, rufen Sie die Ribbons-Eigenschaft der Globals-Klasse auf und übergeben ein Explorer-Objekt, das den Explorer darstellt.

Im folgenden Beispiel wird die Menübandauflistung des Explorers abgerufen, der gerade den Fokus besitzt. In diesem Beispiel wird dann auf ein Menüband mit der Bezeichnung Ribbon1 zugegriffen und der Text festgelegt, der in einem Kombinationsfeld im Menüband für Hello World angezeigt wird.

private void Access_Ribbons_By_Explorer()
{
    ThisRibbonCollection ribbonCollection =
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveExplorer()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}

Zugehöriger Inhalt