[Expand]General Information
[Collapse]WinForms Controls
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Collapse]Form Layout Managers
    Side Panel
   [Collapse]Layout and Data Layout Controls
    [Expand]Product Information
    [Expand]Getting Started
    [Expand]Layout Control
    [Expand]Data Layout Control
    [Expand]Layout Item
    [Collapse]Layout Groups
      Layout Group's Settings
      Layout Group's Contents
      Creating Layout Groups
    [Expand]Tabbed Group
    [Expand]Other Layout Elements
    [Expand]Customization Capabilities
    [Expand]Size and Alignment
     Flow Layout
     Table Layout
     Focus Management
    [Expand]Appearance and Look and Feel
    [Expand]Member Tables
   [Expand]Tabbed MDI Manager
    Tab Control
   [Expand]Wizard Control
    Workspace Manager
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Layout Group's Settings

Like regular layout items, layout groups are components, so their settings can be displayed at design time within the Properties window. To select a group and list its settings in the Properties window, click its caption or border. If a layout item is currently selected, you can press the ESC key to select the group that owns this item.

Expanded Caption

Each group displays a caption by default (except for the root group whose caption is initially hidden). The appearance and style of the group caption is dependent on the current paint scheme. A few examples are given below.

Painting style: Office 2010 Blue skin Painting style: Office 2016 Colorful skin Painting style: Office 2016 Dark skin

To specify a group caption, use the group's BaseLayoutItem.Text inherited property. When a group is rendered as a tab page, this property specifies the text displayed within the tab.

The group caption can be aligned along the top, bottom, left or right edge. Use the LayoutControlGroup.TextLocation (BaseLayoutItem.TextLocation) property to specify the caption position.

The group caption visibility is affected by two properties: BaseLayoutItem.TextVisible and LayoutGroup.GroupBordersVisible. The caption is visible if both of these properties are set to true.

Expanded Caption Image

You can display a custom image within the group header, before or after the text.

To specify an image for the group, use one of the following methods.

Use the LayoutGroup.CaptionImageLocation property to specify the image's position.

Expanded Group Styles

You can specify the group border and caption style by modifying the LayoutGroup.GroupStyle property.

If this property has its default Inherited value, the group style depends on the currently applied skin.

Expanded Caption Expand Button

Layout groups can be collapsed and expanded. Although it's possible to collapse and expand layout groups freely in code using the LayoutGroup.Expanded property, end-users are not able to collapse/expand groups at runtime by default. To make this feature available to end-users, enable a group expand button with the LayoutGroup.ExpandButtonVisible property.

The expand button can be displayed at the beginning or at the end of the group header. Use the LayoutGroup.HeaderButtonsLocation property to specify the expand button's position.

Expanded Custom Header Buttons

You can add custom regular and check buttons to the group header using the LayoutGroup.CustomHeaderButtons collection. The position of these buttons is controlled by the LayoutGroup.HeaderButtonsLocation property.

To respond to clicking/checking custom buttons, handle the LayoutGroup.CustomButtonClick, LayoutGroup.CustomButtonChecked and LayoutGroup.CustomButtonUnchecked events.

Expanded Borders and spacing

If a group is not displayed as a tab page, its borders are visible by default. You can, however, hide the borders by setting the LayoutGroup.GroupBordersVisible property to false. Note that hiding borders hides the group's caption as well.

For each layout group, you can specify the inner and outer indents for the borders. It's possible to specify different indents for the top, left, bottom and right edges or specify matching indents. The indents are determined by the BaseLayoutItem.Padding and BaseLayoutItem.Spacing properties. Please refer to the Spacing and Paddings topic for additional information.

Expanded Appearance

The following table covers properties to customize the appearance of layout groups.

Property Description
LayoutItemContainer.AppearanceGroup Specifies the appearance settings for the current group and its children (background colors of the group and its children, the group caption's text color and font settings, etc).
BaseLayoutItem.AppearanceItemCaption Specifies the appearance settings used to paint captions of layout items within the current and nested groups.
LayoutItemContainer.AppearanceTabPage Specifies the appearance settings used to paint tabbed groups that belong to the current and nested groups.

The Layout Control supports the appearance setting inheritance mechanism. For instance, the background color assigned to a group's AppearanceGroup.BackColor property is automatically applied to the group's children (including its nested groups). However, you are still able to change a nested group's AppearanceGroup.BackColor property and so override the parent group's setting.

Generally, instead of customizing the appearance of individual groups, you can customize the appearance settings of the root group. The root group's appearance will be propagated through its nested groups. To access the root group's settings, use the LayoutControl.Root property.

Expanded Customization settings

The ability to customize a group's layout at runtime is determined by the LayoutItemContainer.AllowCustomizeChildren property. If this property is set to false, it's not possible to add items to, remove them from, or move them within the group.

To prevent a group from being hidden in the Customization Form, use the group's BaseLayoutItem.AllowHide property.

Expanded See Also

Is this topic helpful?​​​​​​​