RibbonControl.DrawGroupCaptions Property

Gets or sets whether to draw captions for Ribbon Page Groups.

Namespace: DevExpress.XtraBars.Ribbon

Assembly: DevExpress.XtraBars.v24.2.dll

Declaration

C#

[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Appearance")]
[XtraSerializableProperty]
public DefaultBoolean DrawGroupCaptions { get; set; }

VB.NET

<DefaultValue(DefaultBoolean.Default)>
<DXCategory("Appearance")>
<XtraSerializableProperty>
Public Property DrawGroupCaptions As DefaultBoolean

Property Value

Type	Default	Description
DefaultBoolean	Default	A value that specifies whether to draw captions for Ribbon Page Groups.

Available values:

Name	Description	Return Value
True	The value is true.	0
False	The value is false.	1
Default	The value is specified by a global option or a higher-level object.	2

Remarks

By default, the RibbonControl does not draw Ribbon Page Group captions in the OfficeUniversal and TabletOffice styles (see RibbonControl.RibbonStyle). In other styles, page group captions are displayed.

To always draw Ribbon Page Group captions, enable the DrawGroupCaptions option:

C#

ribbonControl1.DrawGroupCaptions = DevExpress.Utils.DefaultBoolean.True;

VB.NET

ribbonControl1.DrawGroupCaptions = DevExpress.Utils.DefaultBoolean.True

Disable the DrawGroupsBorderMode option to hide group captions:

C#

ribbonControl1.DrawGroupCaptions = DevExpress.Utils.DefaultBoolean.False;

VB.NET

ribbonControl1.DrawGroupCaptions = DevExpress.Utils.DefaultBoolean.False

Note

The DrawGroupCaptions property is in effect only if the RibbonControl.DrawGroupsBorderMode option is enabled. If the DrawGroupsBorderMode option is disabled, page group captions are not displayed regardless of the DrawGroupCaptions property’s value.