Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [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]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Collapse]Form Layout Managers
    Side Panel
   [Collapse]Layout Manager
    [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]Miscellaneous
    [Expand]Examples
    [Expand]Member Tables
   [Expand]Tabbed MDI Manager
    Tab Control
   [Expand]Wizard Control
    Workspace Manager
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

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

Note

The background colors of the layout control's elements cannot be changed if the Layout Control is painted using any skin painting scheme. To change the current painting scheme, use the LayoutControl.LookAndFeel property.

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

How would you rate this topic?​​​​​​​