RibbonOfficeMenu Schnittstelle

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Ribbon

Assemblys:: Microsoft.Office.Tools.Common.dll, Microsoft.Office.Tools.Common.v4.0.Utilities.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

public interface class RibbonOfficeMenu : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonComponent, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("49cea6a9-3670-4ae0-9a36-9305e27f302b")]
public interface RibbonOfficeMenu : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonComponent, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("49cea6a9-3670-4ae0-9a36-9305e27f302b")>]
type RibbonOfficeMenu = interface
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonOfficeMenu
Implements IComponent, IDisposable, RibbonComponent

Attribute: GuidAttribute

Implementiert: RibbonComponent IComponent IDisposable

Beispiele

Im folgenden Beispiel werden die benutzerdefinierten Steuerelemente im Menü menü Menüband Office durchlaufen und deren Name angezeigt. Um dieses Codebeispiel auszuführen, müssen Sie zunächst die folgenden Schritte ausführen:

Fügen Sie einem Office-Projekt ein Menübandelement (Visual Designer) hinzu.
Fügen Sie der Microsoft Office-Schaltfläche eine Schaltfläche hinzu.
Legen Sie die Eigenschaft (Name) der Schaltfläche auf fest myOfficeMenuButton.
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 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);
    }
}

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

Hinweise

Wenn Sie ihrem Projekt ein Menübandelement (Visual Designer) hinzufügen, weist Visual Studio der OfficeMenu Eigenschaft der generierten OfficeRibbon Schnittstelle automatisch ein neues RibbonOfficeMenu Objekt zu. Verwenden Sie dieses Objekt, um dem Microsoft Office-Menü zur Laufzeit neue Steuerelemente hinzuzufügen oder auf Steuerelemente zuzugreifen, die Sie dem Microsoft Office-Menü hinzugefügt haben.

Sie können Steuerelemente zur Laufzeit hinzufügen, aber nur, bevor das Menüband geladen wird. Erstellen Sie eine instance des Steuerelements, und fügen Sie das neue Steuerelement dann der Items Auflistung hinzu. Weitere Informationen finden Sie unter Übersicht über das Menübandobjektmodell.

Hinweis

Diese Schnittstelle wird von der Visual Studio-Tools für Office-Laufzeit implementiert. Es ist nicht vorgesehen, dass der Typ direkt vom Code implementiert wird. Weitere Informationen finden Sie unter Visual Studio Tools for Office Runtime Overview.

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

Items	Ruft die Menüband-Steuerelemente ab, die Sie zum Microsoft Office-Menü hinzugefügt haben.
Name	Ruft den Namen dieser RibbonComponent ab oder legt diesen fest. (Geerbt von RibbonComponent)
Parent	Ruft ein RibbonComponent ab, das das übergeordnete Element von RibbonComponent darstellt. (Geerbt von RibbonComponent)
Ribbon	Ruft das Ribbon-Objekt der obersten Ebene ab, das die Hierarchie der Steuerelemente enthält. (Geerbt von RibbonComponent)
RibbonUI	Ruft die IRibbonUI-Instanz ab, die von der Microsoft Office-Anwendung für den Erweiterbarkeitscode des Menübands bereitgestellt wird. (Geerbt von RibbonComponent)
Tag	Ruft anwendungsspezifische Daten ab, die diesem RibbonComponent zugeordnet sind, oder legt diese fest. (Geerbt von RibbonComponent)

Methoden

PerformDynamicLayout()	Ruft die Microsoft.Office.Core.IRibbonUI.InvalidateControl-Methode des übergeordneten Steuerelements auf, wenn die RibbonComponent-Schnittstelle über ein dynamisches übergeordnetes Element verfügt (z.B. ein dynamisches Menü), und das Layout nicht angehalten wird. (Geerbt von RibbonComponent)
PerformLayout()	Ruft die Microsoft.Office.Core.IRibbonUI.InvalidateControl-Methode auf, wenn RibbonComponent über ein übergeordnetes Element verfügt und das Layout nicht angehalten wird. (Geerbt von RibbonComponent)
ResumeLayout()	Kehrt den Effekt der SuspendLayout()-Methode um. (Geerbt von RibbonComponent)
ResumeLayout(Boolean)	Kehrt den Effekt der SuspendLayout()-Methode um. (Geerbt von RibbonComponent)
SuspendLayout()	Hindert die Microsoft Office-Anwendung am Aktualisieren des Zustands der Steuerelemente auf dem Menüband. (Geerbt von RibbonComponent)

Gilt für: