Skip to main content
Bar

BarButtonGroup.ButtonGroupsLayout Property

Gets or sets the number of rows that all BarButtonGroups that follow this BarButtonGroup will occupy.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

[DefaultValue(ButtonGroupsLayout.Default)]
[DXCategory("Layout")]
public ButtonGroupsLayout ButtonGroupsLayout { get; set; }

Property Value

Type Default Description
DevExpress.XtraBars.ButtonGroupsLayout Default

A DevExpress.XtraBars.ButtonGroupsLayout enumerator value that specifies the number of rows that all BarButtonGroups that follow this BarButtonGroup will occupy.

Remarks

All BarButtonGroups that follow each other and are located within one RibbonPageGroup are technically considered as one logical group (cluster). The ButtonGroupsLayout property allows you to specify the group layout for the entire cluster, if applied to its first BarButtonGroup. The figure below illustrates a sample layout.

XtraBars - ButtonGroupsLayout

There are four BarButtonGroups within one page group. Groups 2, 3 and 4 form a cluster that does not include Group 1, because this group is separated from the others with a BarButtonItemLink. This means the ButtonGroupsLayout property value for Group 1 cannot affect the group cluster layout. The same applies to groups Group 3 and Group 4, since neither one is the first group in the cluster. The ButtonGroupsLayout property values for all of these groups are irrelevant. The only group that can affect the cluster layout is Group 2. In the image above, this group’s ButtonGroupsLayout property is set to ThreeRows. You can also select TwoRows, Auto and Default (equal to Auto).

See Also