RibbonOfficeMenu-Schnittstelle

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

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

Syntax

'Declaration
<GuidAttribute("49cea6a9-3670-4ae0-9a36-9305e27f302b")> _
Public Interface RibbonOfficeMenu _
    Inherits RibbonComponent, IComponent, IDisposable

[GuidAttribute("49cea6a9-3670-4ae0-9a36-9305e27f302b")]
public interface RibbonOfficeMenu : RibbonComponent, 
    IComponent, IDisposable

Der RibbonOfficeMenu-Typ macht die folgenden Member verfügbar.

Eigenschaften

	Name	Beschreibung
	Items	Ruft die Menüband-Steuerelemente ab, die dem Microsoft Office-Menü hinzugefügt wurden.
	Name	Ruft den Namen dieser RibbonComponent ab oder legt diesen fest. (Von RibbonComponent geerbt.)
	Parent	Ruft eine RibbonComponent ab, die die übergeordnete Komponente von RibbonComponent darstellt. (Von RibbonComponent geerbt.)
	Ribbon	Ruft das Ribbon-Objekt auf der obersten Ebene ab, das die Steuerelementhierarchie beinhaltet. (Von RibbonComponent geerbt.)
	RibbonUI	Infrastruktur. Ruft die IRibbonUI-Instanz ab, die von der Microsoft Office-Anwendung für den Erweiterbarkeitscode des Menübands bereitgestellt wird. (Von RibbonComponent geerbt.)
	Site	Ruft die ISite ab, die IComponent zugeordnet ist, oder legt diese fest. (Von IComponent geerbt.)
	Tag	Ruft anwendungsspezifische Daten ab, die RibbonComponent zugeordnet sind, oder legt diese fest. (Von RibbonComponent geerbt.)

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Dispose	Führt anwendungsspezifische Aufgaben aus, die mit dem Freigeben, Zurückgeben oder Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. (Von IDisposable geerbt.)
	PerformDynamicLayout	Ruft die Microsoft.Office.Core.IRibbonUI.InvalidateControl-Methode des übergeordneten Steuerelements ab, wenn die RibbonComponent über ein dynamisches übergeordnetes Element, z. B. ein dynamisches Menü, verfügt; das Layout wird nicht gesperrt. (Von RibbonComponent geerbt.)
	PerformLayout	Ruft Microsoft.Office.Core.IRibbonUI.InvalidateControl auf, falls RibbonComponent über ein übergeordnetes Element verfügt und das Layout nicht angehalten wurde. (Von RibbonComponent geerbt.)
	ResumeLayout()	Kehrt den Effekt der SuspendLayout-Methode um. (Von RibbonComponent geerbt.)
	ResumeLayout(Boolean)	Kehrt den Effekt der SuspendLayout-Methode um. (Von RibbonComponent geerbt.)
	SuspendLayout	Hindert die Microsoft Office-Anwendung am Aktualisieren des Zustands der Steuerelemente auf dem Menüband. (Von RibbonComponent geerbt.)

Zum Seitenanfang

Ereignisse

	Name	Beschreibung
	Disposed	Stellt die Methode dar, die das Disposed-Ereignis einer Komponente behandelt. (Von IComponent geerbt.)

Zum Seitenanfang

Hinweise

Beim Hinzufügen eines Elements von Menüband (Visual Designer) zum Projekt ordnet Visual Studio automatisch ein neues RibbonOfficeMenu-Objekt der OfficeMenu-Eigenschaft der generierten OfficeRibbon-Schnittstelle 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 des Menübands möglich. Erstellen Sie eine Instanz des Steuerelements, und fügen Sie der Items-Auflistung anschließend das neue Steuerelement hinzu. Weitere Informationen finden Sie unter Multifunktionsleisten-Objektmodellübersicht.

Verwendung

In dieser Dokumentation wird die Version dieses Typs beschrieben, der in Office-Projekten mit der Zielversion .NET Framework 4 verwendet wird. In Projekten mit der Zielversion .NET Framework 3.5 verfügt dieser Typ möglicherweise über unterschiedliche Member und die für diesen Typ bereitgestellten Codebeispiele funktionieren möglicherweise nicht. Dokumentation zu diesem Typ in Projekten mit der Zielversion .NET Framework 3.5 finden Sie im folgenden Verweisabschnitt in der Visual Studio 2008-Dokumentation: https://go.microsoft.com/fwlink/?LinkId=160658.

Beispiele

Im folgenden Beispiel werden die benutzerdefinierten Steuerelemente im Menüband von Office durchlaufen, und deren Name wird angezeigt. Zum Ausführen dieses Codebeispiels müssen zuerst die folgenden Schritte ausgeführt werden:

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

2. Fügen Sie der Microsoft Office-Schaltfläche eine Schaltfläche hinzu.

3. Legen Sie die (Name)-Eigenschaft der Schaltfläche auf myOfficeMenuButton fest.

4. Legen Sie die PositionType-Eigenschaft unter der Position-Eigenschaft auf AfterOfficeID fest.

5. 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);
    }
}

Siehe auch

Referenz

Microsoft.Office.Tools.Ribbon-Namespace

Weitere Ressourcen

Gewusst wie: Anpassen des Microsoft Office-Menüs

Multifunktionsleisten-Objektmodellübersicht