Freigeben über


Zugreifen auf die Multifunktionsleiste zur Laufzeit

Sie können Code schreiben, um das Menüband anzuzeigen, auszublenden und zu ändern und Benutzern die Möglichkeit bieten, den Code von Steuerelementen in einem benutzerdefinierten Aufgabenbereich, einem Aktionsbereich oder einem Outlook-Formularbereich auszuführen.

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

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokumentebene für die folgenden Anwendungen: Excel 2007 und Excel 2010, InfoPath 2010, Outlook 2007 und Outlook 2010, PowerPoint 2007 und PowerPoint 2010, Project 2010, Visio 2010, Word 2007 und Word 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

Zugreifen auf das Menüband mithilfe der Globals-Klasse

Mit der Globals-Klasse können Sie von einer beliebigen Position im Projekt auf das Menüband in einem Projekt auf Dokument- oder Anwendungsebene zugreifen.

Weitere Informationen über die Globals-Klasse finden Sie unter Globaler Zugriff auf Objekte in Office-Projekten.

Im folgenden Beispiel wird mithilfe der Globals-Klasse auf ein benutzerdefiniertes Menüband mit der Bezeichnung Ribbon1 zugegriffen, und der Text, der in einem Kombinationsfeld auf dem Menüband angezeigt wird, auf Hello World festgelegt.

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 Auflistung von Menübändern, die in einem bestimmten Fenster von Outlook-Inspektor angezeigt werden

Sie können auf eine Auflistung von Menübändern zugreifen, die in Outlook-Inspektoren angezeigt werden. Bei einem Inspektor handelt es sich um ein Fenster, das in Outlook geöffnet wird, wenn Benutzer bestimmte Aufgaben ausführen, beispielsweise E-Mails erstellen. Wenn Sie auf das Menüband eines Inspektorfensters zugreifen möchten, rufen Sie die Ribbons-Eigenschaft der Globals-Klasse auf, und übergeben Sie ein Inspector-Objekt, das den Inspektor darstellt.

Im folgenden Beispiel wird die Menübandauflistung des Inspektors abgerufen, die derzeit im Fokus steht. In diesem Beispiel wird anschließend auf ein Menüband mit der Bezeichnung Ribbon1 zugegriffen, und der Text, der in einem Kombinationsfeld des Menübands angezeigt wird, wird auf Hello World festgelegt.

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 Auflistung von Menübändern, die für einen bestimmten Outlook-Explorer angezeigt werden

Sie können auf eine Auflistung von Menübändern zugreifen, die in einem Outlook-Explorer angezeigt werden. Ein Explorer ist die Benutzeroberfläche der Hauptanwendung für eine Instanz von Outlook. Wenn Sie auf das Menüband eines Explorer-Fensters zugreifen möchten, rufen Sie die Ribbons-Eigenschaft der Globals-Klasse auf, und übergeben Sie ein Explorer-Objekt, das den Explorer darstellt.

Im folgenden Beispiel wird die Menübandauflistung des Explorers abgerufen, die derzeit im Fokus steht. In diesem Beispiel wird anschließend auf ein Menüband mit der Bezeichnung Ribbon1 zugegriffen, und der Text, der in einem Kombinationsfeld des Menübands angezeigt wird, wird auf Hello World festgelegt.

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

Aufgaben

Exemplarische Vorgehensweise: Erstellen einer benutzerdefinierten Registerkarte mit dem Multifunktionsleisten-Designer

Exemplarische Vorgehensweise: Aktualisieren der Steuerelemente in einer Multifunktionsleiste zur Laufzeit

Konzepte

Multifunktionsleisten-Designer

Multifunktionsleisten-XML

Multifunktionsleisten-Objektmodellübersicht

Anpassen einer Multifunktionsleiste in Outlook

Zugreifen auf einen Formularbereich zur Laufzeit

Weitere Ressourcen

Übersicht über die Multifunktionsleiste