Back to Devexpress

RibbonControl.DrawGroupCaptions Property

windowsforms-devexpress-dot-xtrabars-dot-ribbon-dot-ribboncontrol-d8e142a6.md

latest3.8 KB
Original Source

RibbonControl.DrawGroupCaptions Property

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

Namespace : DevExpress.XtraBars.Ribbon

Assembly : DevExpress.XtraBars.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

csharp
[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Appearance")]
[XtraSerializableProperty]
public DefaultBoolean DrawGroupCaptions { get; set; }
vb
<DefaultValue(DefaultBoolean.Default)>
<DXCategory("Appearance")>
<XtraSerializableProperty>
Public Property DrawGroupCaptions As DefaultBoolean

Property Value

TypeDefaultDescription
DefaultBooleanDefault

A value that specifies whether to draw captions for Ribbon Page Groups.

|

Available values:

NameDescriptionReturn 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:

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

Disable the DrawGroupsBorderMode option to hide group captions:

csharp
ribbonControl1.DrawGroupCaptions = DevExpress.Utils.DefaultBoolean.False;
vb
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.

See Also

DrawGroupsBorderMode

Ribbon Page Group

RibbonStyle

RibbonControl Class

RibbonControl Members

DevExpress.XtraBars.Ribbon Namespace