RibbonBase Klasse

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Ribbon

Assembly:: 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.

Dient als Basisklasse für Anpassungen von Microsoft Office-Menübändern.

public ref class RibbonBase abstract : System::ComponentModel::Component, IDisposable, Microsoft::Office::Tools::Ribbon::IRibbonExtension

[System.ComponentModel.ToolboxItem(false)]
public abstract class RibbonBase : System.ComponentModel.Component, IDisposable, Microsoft.Office.Tools.Ribbon.IRibbonExtension

[<System.ComponentModel.ToolboxItem(false)>]
type RibbonBase = class
    inherit Component
    interface IRibbonExtension
    interface IExtension
    interface IDisposable

Public MustInherit Class RibbonBase
Inherits Component
Implements IDisposable, IRibbonExtension

Vererbung: Component
RibbonBase

Attribute: ToolboxItemAttribute

Implementiert: IExtension IRibbonExtension IDisposable

Hinweise

Wenn Sie einem Office-Projekt ein neues Menübandelement (Visual Designer) hinzufügen, fügt Visual Studio dem Projekt eine Menübandklasse hinzu, die von RibbonBase erbt. RibbonBase enthält Methoden und Eigenschaften, die allen Menübandklassen gemeinsam sind. Weitere Informationen finden Sie unter Ribbon Designer.

Einige Eigenschaften von RibbonBase können nur festgelegt werden, bevor das Menüband in die Office-Anwendung geladen wird. Informationen zum Festlegen dieser Eigenschaften finden Sie unter Übersicht über das Menübandobjektmodell.

Verbrauch

Dieser Typ wird nur in Office-Projekten verwendet, die auf .NET Framework 4 und höher ausgerichtet sind. Die Assembly, die diesen Typ definiert, ist nicht Teil der Visual Studio-Tools für Office-Laufzeit. Diese Assembly muss mit Ihrer Lösung bereitgestellt werden. Weitere Informationen finden Sie unter Assemblys in den Visual Studio-Tools für Office Runtime.

Konstruktoren

RibbonBase(RibbonFactory)

Initialisiert eine neue Instanz der RibbonBase-Klasse.

Eigenschaften

Base	Ruft das RibbonBase-Objekt ab, das von diesem RibbonBase-Objekt erweitert wird.
Context	Ruft das Inspektorfenster oder das diesem Menüband zugeordnete Explorer-Fenster in Outlook ab.
Factory	Ruft die Menübandfactory ab bzw. legt die Menübandfactory fest, die dieser RibbonBase zugeordnet ist.
Global	Ruft einen Wert ab bzw. legt einen Wert fest, mit dem bestimmt wird, ob RibbonBase gleichzeitig in mehreren Kontexten verwendet werden kann.
Name	Ruft den Namen dieser RibbonBase ab oder legt diesen fest.
OfficeMenu	Ruft ein RibbonOfficeMenu ab, das die Anpassung des Microsoft Office-Menüs darstellt.
Parent	Ruft eine RibbonComponent ab, die das übergeordnete Element der RibbonComponent dieser RibbonBase darstellt.
RibbonId	Ruft die Menüband-ID ab, mit der diese Instanz der RibbonBase-Klasse erstellt wurde.
RibbonType	Ruft eine durch Trennzeichen getrennte Liste von Menüband-IDs ab, die dieser RibbonBase-Instanz zugeordnet sind.
RibbonUI	Ruft die IRibbonUI-Instanz ab, die von der Microsoft Office-Anwendung für den Erweiterbarkeitscode des Menübands bereitgestellt wird.
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 RibbonBase zugeordnet sind, oder legt diese fest.

Methoden

Dispose(Boolean)	Gibt die von der RibbonBase-Klasse verwendeten nicht verwalteten Ressourcen frei und gibt (optional) auch die verwalteten Ressourcen frei.
PerformDynamicLayout()	Ruft die Microsoft.Office.Core.IRibbonUI.InvalidateControl-Methode des übergeordneten Steuerelements auf, wenn die RibbonComponent der RibbonBase über ein dynamisches übergeordnetes Element, z.B. ein dynamisches Menü, verfügt, und das Layout nicht angehalten wird.
PerformLayout()	Aktualisiert die Benutzeroberfläche des Menübands.
ResumeLayout()	Kehrt den Effekt der SuspendLayout()-Methode um.
ResumeLayout(Boolean)	Kehrt den Effekt der SuspendLayout()-Methode um.
SuspendLayout()	Hindert die Microsoft Office-Anwendung am Aktualisieren des Zustands der Steuerelemente auf dem Menüband.

Ereignisse

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

Explizite Schnittstellenimplementierungen

IExtension.ExtensionBase