RibbonOfficeMenu-Klasse (2007 System)

Artikel
08/23/2008

Aktualisiert: November 2007

Stellt Zugriff auf Steuerelemente bereit, die dem Microsoft Office-Menü hinzugefügt werden.

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

Syntax

Public NotInheritable Class RibbonOfficeMenu _
    Inherits RibbonComponent

Dim instance As RibbonOfficeMenu

public sealed class RibbonOfficeMenu : RibbonComponent

Hinweise

Beim Hinzufügen eines Elements von Multifunktionsleiste (Visual Designer) zum Projekt ordnet Visual Studio Tools for Office der OfficeMenu-Eigenschaft der generierten OfficeRibbon-Klasse automatisch ein neues RibbonOfficeMenu-Objekt zu. Fügen Sie dem Microsoft Office-Menü mithilfe dieses Objekts während der Laufzeit neue Steuerelemente zu, oder greifen Sie auf Steuerelemente zu, die Sie dem Microsoft Office-Menü hinzugefügt haben.

Sie können Steuerelemente während der Laufzeit hinzufügen. Dies ist jedoch nur vor dem Laden der Multifunktionsleiste möglich. Erstellen Sie eine Instanz des Steuerelements, und fügen Sie der Items-Auflistung anschließend das neue Steuerelement hinzu. Weitere Informationen hierzu finden Sie unter Multifunktionsleisten-Objektmodellübersicht.

Beispiele

Im folgenden Beispiel werden die benutzerdefinierten Steuerelemente auf der Multifunktionsleiste von Office durchlaufen, und deren Name wird angezeigt. 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 Microsoft Office-Schaltfläche eine Schaltfläche hinzu.
Legen Sie die (Name)-Eigenschaft der Schaltfläche auf myOfficeMenuButton fest.
Legen Sie die PositionType-Eigenschaft unter der Position-Eigenschaft auf AfterOfficeID fest.
Legen Sie die OfficeID-Eigenschaft unter der Position-Eigenschaft auf FilePrintMenu fest.

Private Sub ListOfficeRibbonCustomControls()
    System.Windows.Forms.MessageBox.Show( _
            "Listing all Office Menu custom controls...")
    For Each control As RibbonComponent In Globals.Ribbons.Ribbon1.OfficeMenu.Items
        System.Windows.Forms.MessageBox.Show("Control name: " + control.Name)
    Next
End Sub

private void ListOfficeRibbonCustomControls()
{
    System.Windows.Forms.MessageBox.Show(
        "Listing all Office Menu custom controls...");
    foreach (RibbonComponent control in Globals.Ribbons.Ribbon1.OfficeMenu.Items)
    {
        System.Windows.Forms.MessageBox.Show("Control name: " + control.Name);
    }
}

Vererbungshierarchie

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      Microsoft.Office.Tools.Ribbon.RibbonComponent
        Microsoft.Office.Tools.Ribbon.RibbonOfficeMenu

Threadsicherheit

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