Freigeben über


OfficeRibbon-Schnittstelle

Stellt eine Microsoft Office-Menübandanpassung dar, die mit dem Menüband-Designer in einem Office-Projekt in Visual Studio erstellt wird.

Namespace:  Microsoft.Office.Tools.Ribbon
Assemblys:   Microsoft.Office.Tools.Common.v4.0.Utilities (in Microsoft.Office.Tools.Common.v4.0.Utilities.dll)
  Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)

Syntax

'Declaration
<GuidAttribute("49fbf223-6d24-4c4b-9101-2d5833434328")> _
Public Interface OfficeRibbon _
    Inherits RibbonComponent, IComponent, IDisposable
[GuidAttribute("49fbf223-6d24-4c4b-9101-2d5833434328")]
public interface OfficeRibbon : RibbonComponent, 
    IComponent, IDisposable

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

Eigenschaften

  Name Beschreibung
Öffentliche Eigenschaft Context Ruft das Inspektorfenster oder das diesem Menüband zugeordnete Explorer-Fenster in Outlook ab.
Öffentliche Eigenschaft DefaultExtension Ruft die Standarderweiterung für dieses OfficeRibbon-Objekt ab.
Öffentliche Eigenschaft Extension Ruft eine benutzerdefinierte Erweiterung für dieses OfficeRibbon-Objekt ab.
Öffentliche Eigenschaft Global Ruft einen Wert ab bzw. legt einen Wert fest, mit dem bestimmt wird, ob OfficeRibbon gleichzeitig in mehreren Kontexten verwendet werden kann.
Öffentliche Eigenschaft Name Ruft den Namen dieser RibbonComponent ab oder legt diesen fest. (Von RibbonComponent geerbt.)
Öffentliche Eigenschaft OfficeMenu Ruft ein RibbonOfficeMenu ab, das die Anpassung des Microsoft Office-Menüs darstellt.
Öffentliche Eigenschaft Parent Ruft eine RibbonComponent ab, die die übergeordnete Komponente von RibbonComponent darstellt. (Von RibbonComponent geerbt.)
Öffentliche Eigenschaft Ribbon Ruft das Ribbon-Objekt auf der obersten Ebene ab, das die Steuerelementhierarchie beinhaltet. (Von RibbonComponent geerbt.)
Öffentliche Eigenschaft RibbonId Ruft die Menüband-ID ab, die zum Erstellen dieser Instanz des OfficeRibbon-Objekts verwendet wurde.
Öffentliche Eigenschaft RibbonType Ruft eine durch Trennzeichen getrennte Liste von Menüband-IDs ab, die dieser OfficeRibbon-Instanz zugeordnet sind.
Öffentliche Eigenschaft 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.)
Öffentliche Eigenschaft Site Ruft den dem IComponent zugeordneten ISite ab oder legt diesen fest. (Von IComponent geerbt.)
Öffentliche Eigenschaft 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.
Öffentliche Eigenschaft Tabs Ruft eine Auflistung der RibbonTab-Objekte im RibbonOfficeMenu ab.
Öffentliche Eigenschaft Tag Ruft anwendungsspezifische Daten ab, die RibbonComponent zugeordnet sind, oder legt diese fest. (Von RibbonComponent geerbt.)

Zum Seitenanfang

Methoden

  Name Beschreibung
Öffentliche Methode _VtblGap1_2
Öffentliche Methode Dispose Führt anwendungsspezifische Aufgaben aus, die mit dem Freigeben, Zurückgeben oder Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. (Von IDisposable geerbt.)
Öffentliche Methode 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.)
Öffentliche Methode 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.)
Öffentliche Methode ResumeLayout() Kehrt den Effekt der SuspendLayout-Methode um. (Von RibbonComponent geerbt.)
Öffentliche Methode ResumeLayout(Boolean) Kehrt den Effekt der SuspendLayout-Methode um. (Von RibbonComponent geerbt.)
Öffentliche Methode SuspendLayout Hindert die Microsoft Office-Anwendung am Aktualisieren des Zustands der Steuerelemente auf dem Menüband. (Von RibbonComponent geerbt.)

Zum Seitenanfang

Ereignisse

  Name Beschreibung
Öffentliches Ereignis Close Tritt beim Schließen dieser OfficeRibbon-Instanz auf.
Öffentliches Ereignis Disposed Stellt die Methode dar, die das Disposed-Ereignis einer Komponente behandelt. (Von IComponent geerbt.)
Öffentliches Ereignis Load Tritt ein, wenn das OfficeRibbon in die Microsoft Office-Anwendung geladen wird.
Öffentliches Ereignis LoadImage Tritt auf, wenn OfficeRibbon geladen wird, falls die ImageName-Eigenschaft für mindestens ein Steuerelement festgelegt ist.

Zum Seitenanfang

Hinweise

Die OfficeRibbon-Schnittstelle wird üblicherweise nicht direkt verwendet.Beim Hinzufügen eines neuen Elements von Menüband (Visual Designer) zu Ihrem Projekt können Sie die von Visual Studio generierte Menübandklasse verwenden.Sie können die meisten Aufgaben für das Menüband Formularbereich mit den Ereignissen und Eigenschaften in der generierten Menübandklasse ausführen.

Die generierte Ribbon-Klasse erbt von der RibbonBase-Klasse.Diese Basisklasse leitet alle Aufrufe an ihre Member zu einer internen Implementierung der OfficeRibbon-Schnittstelle in Visual Studio-Tools für Office-Laufzeit um.Wenn Sie mit dem OfficeRibbon-Objekt direkt arbeiten möchten, verwenden Sie die Base-Eigenschaft der generierten Ribbon-Klasse.

HinweisHinweis

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 Übersicht über die Visual Studio Tools for Office-Laufzeit.

Verwendung

Diese Dokumentation beschreibt die Version des Typs, der in Office-Projekten verwendet wird, die auf .NET Framework 4 und .NET Framework 4.5 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. 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.

Siehe auch

Referenz

Microsoft.Office.Tools.Ribbon-Namespace