OfficeRibbon 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 eine Microsoft Office-Menübandanpassung dar, die mit dem Menüband-Designer in einem Office-Projekt in Visual Studio erstellt wird.

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

[System.Runtime.InteropServices.Guid("49fbf223-6d24-4c4b-9101-2d5833434328")]
public interface OfficeRibbon : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonComponent, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("49fbf223-6d24-4c4b-9101-2d5833434328")>]
type OfficeRibbon = interface
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface OfficeRibbon
Implements IComponent, IDisposable, RibbonComponent

Attribute: GuidAttribute

Implementiert: RibbonComponent IComponent IDisposable

Hinweise

In der Regel verwenden Sie die OfficeRibbon Schnittstelle nicht direkt. Verwenden Sie stattdessen die Menübandklasse, die Visual Studio generiert, wenn Sie Ihrem Projekt ein neues Menübandelement (Visual Designer) hinzufügen. Sie können die meisten Aufgaben im Zusammenhang mit dem Menüband ausführen, indem Sie Ereignisse und Eigenschaften in der generierten Ribbon-Klasse verwenden.

Die generierte Menübandklasse erbt von der RibbonBase -Klasse. Diese Basisklasse leitet alle Aufrufe ihrer Member an eine interne Implementierung der OfficeRibbon Schnittstelle der Visual Studio-Tools für Office Runtime um. Wenn Sie direkt mit dem OfficeRibbon Objekt arbeiten möchten, verwenden Sie die Base Eigenschaft der generierten Ribbon-Klasse.

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

Context	Ruft das Inspektorfenster oder das diesem Menüband zugeordnete Explorer-Fenster in Outlook ab.
DefaultExtension	Ruft die Standarddateiendung für das OfficeRibbon-Objekt ab.
Extension	Ruft eine benutzerdefinierte Erweiterung für dieses OfficeRibbon-Objekt ab.
Global	Ruft einen Wert ab bzw. legt einen Wert fest, mit dem bestimmt wird, ob OfficeRibbon gleichzeitig in mehreren Kontexten verwendet werden kann.
Name	Ruft den Namen dieser RibbonComponent ab oder legt diesen fest. (Geerbt von RibbonComponent)
OfficeMenu	Ruft ein RibbonOfficeMenu ab, das die Anpassung des Microsoft Office-Menüs darstellt.
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)
RibbonId	Ruft die Menüband-ID ab, die zum Erstellen dieser Instanz des OfficeRibbon-Objekts verwendet wurde.
RibbonType	Ruft eine durch Trennzeichen getrennte Liste von Menüband-IDs ab, die dieser OfficeRibbon-Instanz zugeordnet sind.
RibbonUI	Ruft die IRibbonUI-Instanz ab, die von der Microsoft Office-Anwendung für den Erweiterbarkeitscode des Menübands bereitgestellt wird. (Geerbt von RibbonComponent)
StartFromScratch	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob alle integrierten Registerkarten auf dem Menüband und die meisten Befehle im Microsoft Office-Menü ausgeblendet und nur die in diesem Menübandelement definierten Anpassungen angezeigt werden sollen.
Tabs	Ruft eine Auflistung der RibbonTab-Objekte im RibbonOfficeMenu ab.
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)

Ereignisse

Close	Tritt beim Schließen dieser OfficeRibbon-Instanz auf.
Load	Tritt ein, wenn das OfficeRibbon in die Microsoft Office-Anwendung geladen wird.
LoadImage	Tritt ein, wenn OfficeRibbon geladen wird, falls die ImageName-Eigenschaft für mindestens ein Steuerelement festgelegt ist.

Gilt für: