RibbonMenu-Klasse (2007 System)

Artikel
08/23/2008

Aktualisiert: November 2007

Stellt ein Menü auf einer Multifunktionsleistenregisterkarte oder im Microsoft Office-Menü dar.

Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common.v9.0 (in Microsoft.Office.Tools.Common.v9.0.dll)

Syntax

<ToolboxBitmapAttribute(GetType(RibbonMenu), "RibbonMenu.bmp")> _
Public NotInheritable Class RibbonMenu _
    Inherits RibbonControl

Dim instance As RibbonMenu

[ToolboxBitmapAttribute(typeof(RibbonMenu), "RibbonMenu.bmp")]
public sealed class RibbonMenu : RibbonControl

Hinweise

Visual Studio Tools for Office erstellt eine Instanz der RibbonMenu-Klasse, wenn ein Menu-Steuerelement von der Registerkarte Steuerelemente für Office-Multifunktionsleisten der Toolbox zum Multifunktionsleisten-Designer gezogen wird.

Allgemeine Aufgaben

In der folgenden Tabelle werden Member aufgeführt, die nützlich bei allgemeinen Aufgaben sind. Alle diese Aufgaben können während der Entwurfszeit ausgeführt werden. Einige dieser Aufgaben können nur während der Laufzeit festgelegt werden, bevor die Multifunktionsleiste in die Office-Anwendung geladen wird oder bevor das Steuerelement während der Laufzeit einem dynamischen Menü hinzugefügt wird. Weitere Informationen finden Sie unter Multifunktionsleisten-Objektmodellübersicht.

Aufgabe	Member
Anzeigen eines Bilds im Menü.	Verwenden Sie die Image-Eigenschaft oder die ImageName-Eigenschaft. Sie können auch Bilder wieder verwenden, die in integrierten Multifunktionsleisten-Steuerelementen angezeigt werden. Legen Sie dazu OfficeImageId auf die ID eines integrierten Microsoft Office-Bilds fest, das Sie als Symbol für das Menü anzeigen möchten.
Ändern der Größe des Menüs.	Legen Sie die ControlSize-Eigenschaft auf den gewünschten Wert fest. Legen Sie die Größe für ein großes Menü beispielsweise auf Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge fest.
Ändern der Größe von Elementen im Menü.	Legen Sie die ItemSize-Eigenschaft auf den gewünschten Wert fest. Legen Sie die Eigenschaft zum Anzeigen größerer Elemente auf Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge fest.
Ermöglichen von Änderungen am Menü während der Laufzeit (beispielsweise das Hinzufügen von Steuerelementen zum Menü während der Laufzeit ermöglichen).	Legen Sie die Dynamic-Eigenschaft auf true fest.
Zugreifen auf die Steuerelemente im Menü, Hinzufügen von Steuerelementen zum Menü oder Entfernen von Steuerelementen aus dem Menü.	Verwenden Sie die Items-Eigenschaft.
Hinzufügen eines Menüs zum Microsoft Office-Menü, zu einer Gruppe oder zu einem anderen Steuerelement, das Menüs beinhalten kann.	Erstellen Sie eine Instanz der RibbonMenu-Klasse mithilfe des RibbonMenu-Konstruktors, und fügen Sie anschließend das neue RibbonMenu der Items-Eigenschaft des Microsoft Office-Menüs bzw. der Gruppe oder des Steuerelements hinzu.

Beispiele

Im folgenden Beispiel wird dargestellt, wie zur Laufzeit einem bestehenden Menü ein Untermenü hinzugefügt wird und wie dieses aufgefüllt wird.

Ein umfangreicheres Beispiel, in dem Steuerelemente zur Laufzeit aktualisiert und Daten mithilfe von Language-Integrated Queries (LINQ) aus der AdventureWorks-Beispieldatenbank abgerufen werden, finden Sie unter Exemplarische Vorgehensweise: Aktualisieren der Steuerelemente in einer Multifunktionsleiste zur Laufzeit.

Zum Ausführen dieses Codebeispiels müssen zuerst die folgenden Schritte ausgeführt werden:

Fügen Sie einem Visual Studio Tools for Office-Projekt ein Element von Multifunktionsleiste (Visual Designer) hinzu.
Fügen Sie der benutzerdefinierten Registerkarte eine Gruppe hinzu.
Fügen Sie der Gruppe ein Menü hinzu.
Legen Sie die (Name)-Eigenschaft des Menüs auf CustomerMenu fest.
Legen Sie die Label-Eigenschaft des Menüs auf Customers fest.
Legen Sie die Dynamic-Eigenschaft des Menüs auf true fest.

Dadurch können Sie Steuerelemente für das Menü während der Laufzeit hinzufügen und entfernen, nachdem die Multifunktionsleiste in die Office-Anwendung geladen wurde.

Private Sub PopulateCustomerMenu()
    ' Add two sub-menus to EmployeeMenu and populate each sub-menu
    ' First sub-menu
    Dim subMenu1 As New RibbonMenu()
    subMenu1.Dynamic = True
    subMenu1.Label = "A - M"
    subMenu1.Items.Add(New RibbonToggleButton())
    CType(subMenu1.Items.Last(), RibbonToggleButton).Label = "Hall, Don"
    subMenu1.Items.Add(New RibbonToggleButton())
    CType(subMenu1.Items.Last(), RibbonToggleButton).Label = "Valdez, Rachel"
    CustomerMenu.Items.Add(subMenu1)

    ' Second sub-menu
    Dim subMenu2 As New RibbonMenu()
    subMenu2.Dynamic = True
    subMenu2.Label = "N - Z"
    subMenu2.Items.Add(New RibbonToggleButton())
    CType(subMenu2.Items.Last(), RibbonToggleButton).Label = "Robinson, Alex"
    CustomerMenu.Items.Add(subMenu2)

End Sub

private void PopulateCustomerMenu()
{
    // Add two sub-menus to EmployeeMenu and populate each sub-menu
    // First sub-menu
    RibbonMenu subMenu1 = new RibbonMenu();
    subMenu1.Dynamic = true;
    subMenu1.Label = "A - M";
    subMenu1.Items.Add(new RibbonToggleButton());
    ((RibbonToggleButton)subMenu1.Items.Last()).Label = "Hall, Don";
    subMenu1.Items.Add(new RibbonToggleButton());
    ((RibbonToggleButton)subMenu1.Items.Last()).Label = "Valdez, Rachel";
    CustomerMenu.Items.Add(subMenu1);

    // Second sub-menu
    RibbonMenu subMenu2 = new RibbonMenu();
    subMenu2.Dynamic = true;
    subMenu2.Label = "N - Z";
    subMenu2.Items.Add(new RibbonToggleButton());
    ((RibbonToggleButton)subMenu2.Items.Last()).Label = "Robinson, Alex";
    CustomerMenu.Items.Add(subMenu2);
}

Vererbungshierarchie

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      Microsoft.Office.Tools.Ribbon.RibbonComponent
        Microsoft.Office.Tools.Ribbon.RibbonControl
          Microsoft.Office.Tools.Ribbon.RibbonMenu

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.