Zugreifen auf das Menüband zur Laufzeit

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 betreffen Projekte auf Dokument - Ebene und VSTO Add - in-Projekte für die folgenden Anwendungen: Excel; InfoPath 2013 und InfoPath 2010; Positiv PowerPoint Projekte Visio Wort. Weitere Informationen finden Sie unter verfügbare Funktionen nach Office-Anwendung und Projekttyp.

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 -Klasse Globals finden Sie unter Globaler 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 Sub Access_All_Ribbons_Globals()
    Globals.Ribbons.Ribbon1.comboBox1.Text = "Hello World"
End Sub
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 Inspektorfenster Outlook 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 Sub Access_Ribbons_By_Inspector()
    Dim ribbonCollection As ThisRibbonCollection = Globals.Ribbons _
        (Globals.ThisAddIn.Application.ActiveInspector())
    ribbonCollection.Ribbon1.ComboBox1.Text = "Hello World"
End Sub
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 Sub Access_Ribbons_By_Explorer()
    Dim ribbonCollection As ThisRibbonCollection = Globals.Ribbons _
        (Globals.ThisAddIn.Application.ActiveExplorer())
    ribbonCollection.Ribbon1.ComboBox1.Text = "Hello World"
End Sub
private void Access_Ribbons_By_Explorer()
{
    ThisRibbonCollection ribbonCollection =
        Globals.Ribbons
            [Globals.ThisAddIn.Application.ActiveExplorer()];
    ribbonCollection.Ribbon1.comboBox1.Text = "Hello World";
}

Siehe auch