windowsforms-devexpress-dot-xtrabars-dot-barbuttongroup-2b1b3cc1.md
Gets or sets the number of rows that all BarButtonGroups that follow this BarButtonGroup will occupy.
Namespace : DevExpress.XtraBars
Assembly : DevExpress.XtraBars.v25.2.dll
NuGet Package : DevExpress.Win.Navigation
[DefaultValue(ButtonGroupsLayout.Default)]
[DXCategory("Layout")]
public ButtonGroupsLayout ButtonGroupsLayout { get; set; }
<DefaultValue(ButtonGroupsLayout.Default)>
<DXCategory("Layout")>
Public Property ButtonGroupsLayout As ButtonGroupsLayout
| 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.
|
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.
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