Freigeben über


RibbonSeparator Schnittstelle

Definition

Stellt ein Trennliniensteuerelement für eine Gruppe oder ein Menü auf dem Menüband dar.

public interface class RibbonSeparator : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent
[System.Runtime.InteropServices.Guid("79cda0e6-be5b-4889-a068-08a6ed0c54cc")]
public interface RibbonSeparator : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent
[<System.Runtime.InteropServices.Guid("79cda0e6-be5b-4889-a068-08a6ed0c54cc")>]
type RibbonSeparator = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable
Public Interface RibbonSeparator
Implements IComponent, IDisposable, RibbonControl
Attribute
Implementiert

Hinweise

Ein RibbonSeparator Steuerelement zeichnet eine Linie, horizontal oder vertikal.

Für das Microsoft Office-Menü ist , RibbonMenuund ein RibbonSplitButtonhorizontal RibbonSeparator .

Für das Menüband ist der vertikal RibbonSeparator .

Sie können die Title -Eigenschaft so festlegen, dass text im Trennzeichen in Menüs enthalten ist.

Wenn sich am RibbonSeparator Ende eines Menüs befindet, wird im RibbonSeparator Menüband Designer, aber nicht in der Microsoft Office-Anwendung angezeigt.

RibbonSeparator implementiert Separator- und menuSeparator RibbonX-Elemente.

Sie können eine RibbonSeparator zur Laufzeit 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.

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

Enabled

Ruft einen Wert ab, der angibt, ob das RibbonControl aktiviert ist, oder legt einen Wert fest.

(Geerbt von RibbonControl)
Id

Ruft eine Zeichenfolge ab, die Microsoft Office zum Identifizieren dieses RibbonControl-Objekts verwendet.

(Geerbt von RibbonControl)
Name

Ruft den Namen dieser RibbonComponent ab oder legt diesen fest.

(Geerbt von RibbonComponent)
Parent

Ruft ein RibbonComponent ab, das das übergeordnete Element von RibbonComponent darstellt.

(Geerbt von RibbonComponent)
Position

Ruft die Position der Trennlinie relativ zu einem integrierten Steuerelement oder die Position einer Gruppe relativ zu einer anderen Gruppe ab, wenn sich die Trennlinie im Microsoft Office-Menü befindet, oder legt die Position fest.

Ribbon

Ruft das Ribbon-Objekt der obersten Ebene ab, das die Hierarchie der Steuerelemente enthält.

(Geerbt von RibbonComponent)
RibbonUI

Ruft die IRibbonUI-Instanz ab, die von der Microsoft Office-Anwendung für den Erweiterbarkeitscode des Menübands bereitgestellt wird.

(Geerbt von RibbonComponent)
Tag

Ruft anwendungsspezifische Daten ab, die diesem RibbonComponent zugeordnet sind, oder legt diese fest.

(Geerbt von RibbonComponent)
Title

Ruft den Text ab, der auf dem RibbonSeparator-Steuerelement angezeigt wird, oder legt ihn fest.

Visible

Ruft einen Wert ab, der angibt, ob das RibbonControl sichtbar ist, oder legt den Wert fest.

(Geerbt von RibbonControl)

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)

Gilt für: