RibbonSeparator-Schnittstelle

Artikel
08/10/2011

Stellt ein Separator-Steuerelement für eine Gruppe oder ein Menü auf dem Menüband dar.

Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)

Syntax

'Declaration
<GuidAttribute("79cda0e6-be5b-4889-a068-08a6ed0c54cc")> _
Public Interface RibbonSeparator _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("79cda0e6-be5b-4889-a068-08a6ed0c54cc")]
public interface RibbonSeparator : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

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

Eigenschaften

	Name	Beschreibung
	Enabled	Ruft einen Wert ab, der angibt, ob RibbonControl aktiviert ist, oder legt diesen fest. (Von RibbonControl geerbt.)
	Id	Ruft eine Zeichenfolge ab, die von Microsoft Office zum Identifizieren dieses RibbonControl-Objekts verwendet wird. (Von RibbonControl geerbt.)
	Name	Ruft den Namen dieser RibbonComponent ab oder legt diesen fest. (Von RibbonComponent geerbt.)
	Parent	Ruft eine RibbonComponent ab, die die übergeordnete Komponente von RibbonComponent darstellt. (Von RibbonComponent geerbt.)
	Position	Ruft die Position des Trennzeichens relativ zu einem integrierten Steuerelement oder die Position einer Gruppe relativ zu einer anderen Gruppe ab oder legt diese Position fest, falls sich das Trennzeichen im Microsoft Office-Menü befindet.
	Ribbon	Ruft das Ribbon-Objekt auf der obersten Ebene ab, das die Steuerelementhierarchie beinhaltet. (Von RibbonComponent geerbt.)
	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.)
	Site	Ruft die ISite ab, die IComponent zugeordnet ist, oder legt diese fest. (Von IComponent geerbt.)
	Tag	Ruft anwendungsspezifische Daten ab, die RibbonComponent zugeordnet sind, oder legt diese fest. (Von RibbonComponent geerbt.)
	Title	Ruft Text ab oder legt Text fest, der auf dem RibbonSeparator-Steuerelement angezeigt wird.
	Visible	Ruft einen Wert ab, der angibt, ob RibbonControl sichtbar ist, oder legt diesen fest. (Von RibbonControl geerbt.)

Zum Seitenanfang

Methoden

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

Zum Seitenanfang

Ereignisse

	Name	Beschreibung
	Disposed	Stellt die Methode dar, die das Disposed-Ereignis einer Komponente behandelt. (Von IComponent geerbt.)

Zum Seitenanfang

Hinweise

Mit einem RibbonSeparator-Steuerelement wird eine horizontale oder vertikale Linie gezeichnet.

Im Microsoft Office-Menü sowie in RibbonMenu und in RibbonSplitButton ist RibbonSeparator horizontal.

Auf dem Menüband ist RibbonSeparator vertikal.

Die Title-Eigenschaft kann so konfiguriert werden, dass sich in Menüs auf dem Trennzeichen Text befindet.

Befindet sich RibbonSeparator am Ende eines Menüs, ist RibbonSeparator im Menüband-Designer, jedoch nicht in der Microsoft Office-Anwendung sichtbar.

RibbonSeparator implementiert Trennzeichenelemente und menuSeparator RibbonX-Elemente.

Sie können zur Laufzeit eine RibbonSeparator erstellen, indem Sie die CreateRibbonSeparator-Methode des RibbonFactory-Objekts verwenden.

Es gibt zwei Möglichkeiten, um auf das RibbonFactory-Objekt zuzugreifen:

Mithilfe der Factory-Eigenschaft der Ribbon-Klasse. Verwenden Sie diesen Ansatz aus Code in der Ribbon-Klasse.
Mithilfe der Globals.Factory.GetRibbonFactory-Methode. Verwenden Sie diesen Ansatz aus Code außerhalb der Ribbon-Klasse.

Tipp

Diese Schnittstelle wird von der Visual Studio Tools for 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

In dieser Dokumentation wird die Version dieses Typs beschrieben, der in Office-Projekten mit der Zielversion .NET Framework 4 verwendet wird. In Projekten mit der Zielversion .NET Framework 3.5 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.