TX Text Control .NET for Windows Forms

RibbonGroup 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. Panel
  2. RibbonGroup
Derived
HorizontalRibbonGroup

Description

The RibbonGroup class represents a logical group of controls as they appear on a RibbonTab and is the base class of the HorizontalRibbonGroup class. An instance of a RibbonGroup can be added to a RibbonTab by using the Add method of its RibbonGroupCollection which is represented by the RibbonTab.RibbonGroups property. The controls of a RibbonGroup are arranged in columns. To arrange them in rows it is recommend to use an instance of type HorizontalRibbonGroup. A RibbonGroup is inherited from the System.Windows.Forms.Panel class. The following describes only the properties, methods and events defined through the RibbonGroup class. For a list of properties, methods and events inherited from the System.Windows.Forms.Panel class see the .NET Framework reference.

Syntax

public class RibbonGroup : Panel

Examples

The following example creates a Ribbon Group instance and configures its horizontal content alignment setting for a document workflow.

using TXTextControl.Windows.Forms.Ribbon.RibbonGroup ribbonGroup = new();
ribbonGroup.HorizontalContentAlignment = TXTextControl.HorizontalAlignment.Center;

Members

Constructors

ConstructorDescription
RibbonGroupInitializes a new instance of the RibbonGroup class.

Properties

PropertyDescription
DialogBoxLauncherGets an object of type DialogBoxLauncher which represents the RibbonGroup's dialog box launcher item.
HorizontalContentAlignmentGets or sets the ribbon group's horizontal content alignment. The default value is TXTextControl.HorizontalAlignment.Left.
IsAddToQuickAccessToolbarEnabledGets or sets a value whether the RibbonGroup can be added to the quick access toolbar.
KeyTipGets or sets the keyboard shortcut of the RibbonGroup.
LargeIconGets or sets an icon for this RibbonGroup. This icon is displayed by the RibbonGroup's menu button which appears when the RibbonGroup shrinks to a width where its items cannot be displayed anymore. If the size of the icon is smaller than 32x32 1/96 inch, the image is drawn centered on the menu button.
RibbonItemsGets a collection of all items contained in this group. These controls can be objects of type RibbonButton, RibbonComboBox, RibbonLabel, RibbonListView or RibbonTextBox. RibbonGroups of type HorizontalRibbonGroup can also add objects of type RibbonSeperator.
RowCountGets or sets the number of rows in the RibbonGroup.
ShowSeperatorGets or sets a value whether the RibbonGroup's separator is shown. The default value is true.
SmallIconGets or sets a 16x16 1/96 inch icon for this RibbonGroup. This icon is displayed by the RibbonGroup's quick access toolbar tool strip item.
TextOverridden. Gets or sets the RibbonGroup's footer text.
ToolTipGets an object of type RibbonToolTip that displays text when the mouse pointer hovers over this RibbonGroup.
VisibleNot described in the reference. public bool Visible { get; set; }