RibbonMenu Schnittstelle

Definition

public interface class RibbonMenu : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("59dc7f42-aca2-484a-9622-1ee34a6cfd7d")]
public interface RibbonMenu : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("59dc7f42-aca2-484a-9622-1ee34a6cfd7d")>]
type RibbonMenu = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonMenu
Implements IComponent, IDisposable, RibbonControl

Attribute

GuidAttribute

Implementiert

RibbonComponent RibbonControl IComponent IDisposable

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein Untermenü zur Laufzeit einem vorhandenen Menü hinzugefügt und aufgefüllt wird.

Ein umfangreicheres Beispiel, das Steuerelemente zur Laufzeit aktualisiert und das Abrufen von Daten aus der AdventureWorks-Beispieldatenbank mithilfe von Language-Integrated Queries (LINQ) umfasst, finden Sie unter Exemplarische Vorgehensweise: Aktualisieren der Steuerelemente auf einem Menüband zur Laufzeit.

Um dieses Codebeispiel auszuführen, müssen Sie zunächst die folgenden Schritte ausführen:

1. Fügen Sie einem Office-Projekt ein Menübandelement (Visual Designer) hinzu.

2. Fügen Sie der benutzerdefinierten Registerkarte eine Gruppe hinzu.

3. Fügen Sie der Gruppe ein Menü hinzu.

4. Legen Sie die Eigenschaft (Name) des Menüs auf fest CustomerMenu.

5. Legen Sie die Label-Eigenschaft des Menüs auf Kunden fest.

6. Legen Sie die Dynamic-Eigenschaft des Menüs auf fest true.

   Auf diese Weise können Schaltflächen für das Menü während der Laufzeit hinzugefügt und entfernt werden, nachdem das Menüband in die Office-Anwendung geladen wurde.

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

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

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

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

End Sub

Hinweise

Visual Studio erstellt ein RibbonMenu -Objekt, wenn Sie ein Menü-Steuerelement von der Registerkarte Office-Menübandsteuerelemente der Toolbox auf das Menüband Designer ziehen.

Sie können eine RibbonMenu zur Laufzeit erstellen, indem Sie die CreateRibbonMenu -Methode des RibbonFactory -Objekts verwenden.

Es gibt zwei Möglichkeiten, um auf das RibbonFactory-Objekt zuzugreifen:

• Mithilfe der Factory-Eigenschaft der Ribbon-Klasse. Verwenden Sie diesen Ansatz aus Code in der Ribbon-Klasse.

• Mithilfe der Globals.Factory.GetRibbonFactory-Methode. Verwenden Sie diesen Ansatz aus Code außerhalb der Ribbon-Klasse.

Allgemeine Aufgaben

In der folgenden Tabelle sind Elemente aufgeführt, die für allgemeine Aufgaben nützlich sind. Alle diese Aufgaben können zur Entwurfszeit ausgeführt werden. Einige dieser Aufgaben können zur Laufzeit nur ausgeführt werden, bevor das Menüband in die Office-Anwendung geladen wird oder bevor das Steuerelement zur Laufzeit einem dynamischen Menü hinzugefügt wird. Weitere Informationen finden Sie unter Übersicht über das Menübandobjektmodell.

Verbrauch

Diese Dokumentation beschreibt die Version des Typs, der in Office-Projekten verwendet wird, die auf .NET Framework 4 und höher ausgerichtet sind. In Projekten, die auf .NET Framework 3.5 abzielen, verfügt dieser Typ möglicherweise über unterschiedliche Member, und die für diesen Typ bereitgestellten Codebeispiele funktionieren möglicherweise nicht. Eine Dokumentation dieser Art von Projekten, die auf den .NET Framework 3.5 abzielen, erhalten Sie in den folgenden Verweisabschnitten in der Dokumentation zu Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Eigenschaften

Methoden

Ereignisse

Gilt für: