TX Text Control .NET for Windows Forms

RibbonSplitButton Class

Class|Introduced in 24.0
Namespace
TXTextControl.Windows.Forms.Ribbon
Package
TXTextControl.TextControl.WinForms.SDK from the private NuGet feed or Text Control Offline Packages
Assembly
TXTextControl.Windows.Forms.dll
Install
dotnet add package TXTextControl.TextControl.WinForms.SDK .NET 8 and later. For .NET Framework, reference TXTextControl.Windows.Forms.dll from the setup.
Inherits
  1. Control
  2. RibbonButton
  3. RibbonMenuButton
  4. RibbonSplitButton
Implements
INotifyPropertyChanged

Description

The RibbonSplitButton class is a control that has a primary button that responds to a Click event and a secondary button that displays a drop-down menu when clicked. Furthermore optionally the primary button can be used as checkable button. The RibbonSplitButton can be added to a RibbonGroup or to a RibbonMenuButton where it is stored as an item of the drop-down menu. The RibbonSplitButton class is inherited from the RibbonMenuButton class. The following describes only the properties, methods and events defined through theRibbonSplitButton class.

Syntax

public class RibbonSplitButton : RibbonMenuButton

Examples

The following example creates a Ribbon Split Button instance and configures its button enabled setting for a document workflow.

using TXTextControl.Windows.Forms.Ribbon.RibbonSplitButton ribbonSplitButton = new();
ribbonSplitButton.ButtonEnabled = true;

Members

Constructors

ConstructorDescription
RibbonMenuButtonInitializes a new instance of the RibbonMenuButton class. (Inherited from RibbonMenuButton.)
RibbonSplitButtonInitializes a new instance of the RibbonSplitButton class.

Properties

PropertyDescription
ButtonEnabledGets or set a value indicating whether the primary button is enabled.
CheckableGets or set a value indicating whether the primary button is checkable.
CheckedGets or set a value indicating whether the primary button is checked.
DropDownItemsGets the collection of controls in the drop-down menu that is associated with this RibbonMenuButton. These controls can be objects of type RibbonButton, RibbonComboBox, RibbonLabel, RibbonListView, RibbonTextBox or RibbonSeperator. (Inherited from RibbonMenuButton.)

Events

EventDescription
ButtonClickOccurs as the primary button is clicked.
CheckedChangedOccurs when the value of the Checked property changes.
DropDownClosedOccurs as the RibbonMenuButton's drop-down menu is closed. (Inherited from RibbonMenuButton.)
DropDownOpeningOccurs as the RibbonMenuButton's drop-down menu is opening. (Inherited from RibbonMenuButton.)