RibbonSplitButton Schnittstelle

Definition

Namespace:

Microsoft.Office.Tools.Ribbon

Assembly:

Microsoft.Office.Tools.Common.dll

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

public interface class RibbonSplitButton : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")]
public interface RibbonSplitButton : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")>]
type RibbonSplitButton = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonSplitButton
Implements IComponent, IDisposable, RibbonControl

Attribute

GuidAttribute

Implementiert

RibbonComponent RibbonControl IComponent IDisposable

Hinweise

Ein RibbonSplitButton Steuerelement kombiniert eine Schaltfläche oder eine Umschaltfläche mit einem Dropdownmenü. Verwenden Sie die -Eigenschaft, um zwischen der Schaltfläche und der ButtonType Umschaltfläche zu wählen.

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

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

ButtonEnabled	Ruft einen Wert ab, der angibt, ob die Schaltfläche für RibbonSplitButton aktiviert ist, oder legt diesen fest.
ButtonType	Ruft den Typ der Schaltfläche auf der RibbonSplitButton ab oder legt diesen fest.
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 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)
Image	Ruft das auf dem Steuerelement angezeigte Bild ab oder legt dieses fest.
ImageName	Ruft den Namen ab, den Sie im E:Microsoft.Office.Tools.Ribbon.LoadImage-Ereignishandler zum Identifizieren eines Images für das Steuerelement verwenden können, oder legt ihn fest.
Items	Ruft die Auflistung der Steuerelemente in RibbonSplitButton ab.
ItemSize	Ruft die Größe der Steuerelemente im RibbonSplitButton-Dropdownmenü ab oder legt diese 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. (Geerbt von RibbonComponent)
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 ein RibbonComponent ab, das das übergeordnete Element von RibbonComponent darstellt. (Geerbt von RibbonComponent)
Position	Ruft die Position des RibbonSplitButton-Steuerelements ab, wenn sich das Steuerelement 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)
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.
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 diesem RibbonComponent zugeordnet sind, oder legt diese fest. (Geerbt von RibbonComponent)
Title	Ruft den Titel des RibbonSplitButton-Steuerelements ab, wenn sich das Steuerelement im Microsoft Office-Menü befindet, oder legt den Titel 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)

Ereignisse

Click

Tritt ein, wenn der Benutzer auf das RibbonSplitButton-Steuerelement klickt.