RibbonSplitButton-Schnittstelle

Artikel
05/07/2013

Ein Menüband-Steuerelement, das eine Schaltfläche bzw. eine Umschaltfläche und ein Dropdownmenü vereint.

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

Syntax

'Declaration
<GuidAttribute("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")> _
Public Interface RibbonSplitButton _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")]
public interface RibbonSplitButton : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

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

Eigenschaften

	Name	Beschreibung
	ButtonEnabled	Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob die Schaltfläche im RibbonSplitButton aktiviert ist.
	ButtonType	Ruft den Typ der Schaltfläche auf RibbonSplitButton ab.
	Checked	Ruft einen Wert ab, der angibt, ob RibbonSplitButton gedrückt wird oder nicht, oder legt diesen Wert fest.
	ControlSize	Ruft die Größe des RibbonSplitButton-Steuerelements ab oder legt diese fest.
	Description	Ruft den Text ab bzw. legt den Text fest, der in einem Dropdownmenü auf diesem RibbonSplitButton-Steuerelement angezeigt wird.
	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.)
	Image	Ruft das auf dem Steuerelement angezeigte Bild ab oder legt dieses fest.
	ImageName	Ruft den Namen ab oder legt den Namen fest, den Sie im E:Microsoft.Office.Tools.Ribbon.LoadImage-Ereignishandler zum Identifizieren eines Bilds für das Steuerelement verwenden können.
	Items	Ruft die Auflistung von Steuerelementen ab, die sich in diesem RibbonSplitButton befinden.
	ItemSize	Ruft die Größe der Steuerelemente im RibbonSplitButton-Dropdownmenü ab oder legt sie fest.
	KeyTip	Ruft die Tastenkombination des RibbonSplitButton-Steuerelements ab oder legt sie fest.
	Label	Ruft den Text auf dem RibbonSplitButton-Steuerelement ab oder legt diesen fest.
	Name	Ruft den Namen dieser RibbonComponent ab oder legt diesen fest. (Von RibbonComponent geerbt.)
	OfficeImageId	Ruft das Bild ab bzw. legt das Bild fest, das auf dem RibbonSplitButton-Steuerelement angezeigt werden soll, wenn Sie ein integriertes Microsoft Office-Symbol verwenden möchten.
	Parent	Ruft eine RibbonComponent ab, die die übergeordnete Komponente von RibbonComponent darstellt. (Von RibbonComponent geerbt.)
	Position	Ruft die Position des RibbonSplitButton-Steuerelements ab oder legt sie fest, falls sich das Steuerelement 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.)
	ScreenTip	Ruft QuickInfo-Text ab, der angezeigt wird, wenn der Benutzer den Zeiger auf das RibbonSplitButton-Steuerelement richtet, oder legt diesen fest.
	ShowLabel	Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob die Bezeichnung für das RibbonSplitButton-Steuerelement sichtbar ist.
	Site	Ruft den dem IComponent zugeordneten ISite ab oder legt diesen fest. (Von IComponent geerbt.)
	SuperTip	Ruft mehrzeiligen QuickInfo-Text ab, der angezeigt wird, wenn der Benutzer den Zeiger auf das RibbonSplitButton-Steuerelement richtet, oder legt diesen fest.
	Tag	Ruft anwendungsspezifische Daten ab, die RibbonComponent zugeordnet sind, oder legt diese fest. (Von RibbonComponent geerbt.)
	Title	Ruft den Titel ab bzw. legt den Titel fest, der oben auf dem RibbonSplitButton-Steuerelement angezeigt wird, falls sich das Steuerelement im Microsoft Office-Menü befindet.
	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
	Click	Tritt ein, wenn der Benutzer auf das RibbonSplitButton-Steuerelement klickt.
	Disposed	Stellt die Methode dar, die das Disposed-Ereignis einer Komponente behandelt. (Von IComponent geerbt.)

Zum Seitenanfang

Hinweise

Ein RibbonSplitButton-Steuerelement vereint eine Schaltfläche bzw. eine Umschaltfläche und ein Dropdownmenü.Mit der ButtonType-Eigenschaft wählen Sie entweder die Schaltfläche oder die Umschaltfläche.

Im Gegensatz zum RibbonMenu-Steuerelement verfügt das RibbonSplitButton-Steuerelement nicht über die Dynamic-Eigenschaft, sodass der Inhalt der Items-Auflistung während der Laufzeit nicht geändert werden kann.

Sie können zur Laufzeit eine RibbonSplitButton erstellen, indem Sie die CreateRibbonSplitButton-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 Ü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.