RibbonBase-Klasse
Dient als Basisklasse für Anpassungen von Microsoft Office-Menübändern.
Vererbungshierarchie
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
Microsoft.Office.Tools.Ribbon.RibbonBase
Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common.v4.0.Utilities (in Microsoft.Office.Tools.Common.v4.0.Utilities.dll)
Syntax
'Declaration
Public MustInherit Class RibbonBase _
Inherits Component _
Implements IRibbonExtension, IExtension, IDisposable
public abstract class RibbonBase : Component,
IRibbonExtension, IExtension, IDisposable
Der RibbonBase-Typ macht die folgenden Member verfügbar.
Konstruktoren
| Name | Beschreibung | |
|---|---|---|
.gif "Öffentliche Methode") |
RibbonBase | Infrastruktur. Initialisiert eine neue Instanz der RibbonBase-Klasse. |
Zum Seitenanfang
Eigenschaften
| Name | Beschreibung | |
|---|---|---|
.gif "Öffentliche Eigenschaft") |
Base | Ruft das RibbonBase-Objekt ab, das von diesem RibbonBase-Objekt erweitert wird. |
.gif "Geschützte Eigenschaft") |
CanRaiseEvents | Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Von Component geerbt.) |
|
Container | Ruft den IContainer ab, der die Component enthält. (Von Component geerbt.) |
|
Context | Ruft das Inspektorfenster oder das diesem Menüband zugeordnete Explorer-Fenster in Outlook ab. |
|
DesignMode | Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Von Component geerbt.) |
|
Events | Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Von Component geerbt.) |
|
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 diese 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 | Infrastruktur. Ruft die IRibbonUI-Instanz ab, die von der Microsoft Office-Anwendung für den Erweiterbarkeitscode des Menübands bereitgestellt wird. |
|
Site | Ruft die ISite der Component ab oder legt diese fest. (Von Component geerbt.) |
|
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 dieser RibbonBase zugeordnet sind, oder legt diese fest. |
Zum Seitenanfang
Methoden
| Name | Beschreibung | |
|---|---|---|
|
CreateObjRef | Sicherheitsrelevant. Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Von MarshalByRefObject geerbt.) |
|
Dispose() | Gibt alle vom Component verwendeten Ressourcen frei. (Von Component geerbt.) |
.gif "Geschützte Methode") |
Dispose(Boolean) | Gibt die von der RibbonBase-Klasse verwendeten nicht verwalteten Ressourcen frei und gibt (optional) auch die verwalteten Ressourcen frei. (Überschreibt Component.Dispose(Boolean).) |
|
Equals | Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.) |
|
Finalize | Gibt nicht verwaltete Ressourcen frei und führt andere Bereinigungsvorgänge durch, bevor die Component durch die Garbage Collection wieder zugänglich gemacht wird. (Von Component geerbt.) |
|
GetHashCode | Fungiert als die Standardhashfunktion. (Von Object geerbt.) |
|
GetLifetimeService | Sicherheitsrelevant. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Von MarshalByRefObject geerbt.) |
|
GetService | Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Von Component geerbt.) |
|
GetType | Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.) |
|
InitializeLifetimeService | Sicherheitsrelevant. Ruft ein Lebensdauerdienstobjekt ab, mit dem die Lebensdauerrichtlinien für diese Instanz gesteuert werden können. (Von MarshalByRefObject geerbt.) |
|
MemberwiseClone() | Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.) |
|
MemberwiseClone(Boolean) | Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Von MarshalByRefObject geerbt.) |
|
PerformDynamicLayout | Ruft die Microsoft.Office.Core.IRibbonUI.InvalidateControl-Methode des übergeordneten Steuerelements ab, wenn die RibbonComponent der RibbonBase über ein dynamisches übergeordnetes Element (z. B. ein dynamisches Menü) verfügt; das Layout wird nicht gesperrt. |
|
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. |
|
ToString | Gibt einen String zurück, der den Namen dieser Component enthält, sofern vorhanden.Diese Methode sollte nicht überschrieben werden. (Von Component geerbt.) |
Zum Seitenanfang
Ereignisse
| Name | Beschreibung | |
|---|---|---|
.gif "Öffentliches Ereignis") |
Close | Tritt beim Schließen dieser RibbonBase-Instanz auf. |
|
Disposed | Tritt ein, wenn die Komponente durch einen Aufruf der Dispose-Methode freigegeben wird. (Von Component geerbt.) |
|
Load | Tritt ein, wenn die RibbonBase in die Microsoft Office-Anwendung geladen wird. |
|
LoadImage | Tritt auf, wenn RibbonBase geladen wird, falls die ImageName-Eigenschaft für mindestens ein Steuerelement festgelegt ist. |
Zum Seitenanfang
Explizite Schnittstellenimplementierungen
| Name | Beschreibung | |
|---|---|---|
.gif "Explizite Schnittstellenimplementierung") .gif "Private Eigenschaft") |
IExtension.ExtensionBase | Infrastruktur. |
Zum Seitenanfang
Hinweise
Beim Hinzufügen eines neuen Elements von Menüband (Visual Designer) zu einem Office-Projekt fügt Visual Studio dem Projekt eine Ribbon-Klasse hinzu, die von RibbonBase erbt. RibbonBase beinhaltet Methoden und Eigenschaften, die für alle Menübandklassen typisch sind. Weitere Informationen finden Sie unter Multifunktionsleisten-Designer.
Einige Eigenschaften von RibbonBase können nur vor dem Laden des Menübands in die Office-Anwendung festgelegt werden. Informationen zum Festlegen dieser Eigenschaften finden Sie unter Multifunktionsleisten-Objektmodellübersicht.
Verwendung
Dieser Typ wird nur in Office-Projekten verwendet, die auf .NET Framework 4 und .NET Framework 4.5 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 Visual Studio Tools for Office Runtime.
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.