LayoutGroup.GroupBorderStyle Property

Gets or sets the group’s border style. This option is in effect when the LayoutGroup is used to combine layout items, rather than dock items. This is a dependency property.

Namespace: DevExpress.Xpf.Docking

Assembly: DevExpress.Xpf.Docking.v19.1.dll

Declaration

C#

public virtual GroupBorderStyle GroupBorderStyle { get; set; }

VB.NET

Public Overridable Property GroupBorderStyle As GroupBorderStyle

Property Value

Type	Description
GroupBorderStyle	A GroupBorderStyle value that specifies the group’s border style.

Available values:

Name	Description
NoBorder	A container has no borders.
Group	A container is displayed with borders and caption.
GroupBox	A container is displayed with borders and title bar.
Tabbed	Child items are represented as tabs.

Remarks

Use the GroupBorderStyle property to specify how the group’s borders are rendered.

The GroupBorderStyle.Group style:

The GroupBorderStyle.GroupBox style:

The GroupBorderStyle.Tabbed style:

Note that the same group border style may be visually rendered differently in different paint themes.

The group’s caption specified by the BaseLayoutItem.Caption property is not displayed if the BaseLayoutItem.ShowCaption option is disabled.

For groups without borders, you can enable larger indents than those of other groups. See LayoutGroup.HasAccent to learn more.

Example

This example shows how to create a LayoutGroup, representing its children as tabs. The tabbed interface for the group is enabled via the GroupBorderStyle property.

The following image shows the result:

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-enable-the-tabbed-ui-for-a-layout-group-e2109.

MainWindow.xaml.vb

Imports Microsoft.VisualBasic
Imports System
Imports System.Collections.Generic
Imports System.Linq
Imports System.Text
Imports System.Windows
Imports System.Windows.Controls
Imports System.Windows.Data
Imports System.Windows.Documents
Imports System.Windows.Input
Imports System.Windows.Media
Imports System.Windows.Media.Imaging
Imports System.Windows.Navigation
Imports System.Windows.Shapes

Namespace Docking_Layout_TabGroups
    ''' <summary>
    ''' Interaction logic for MainWindow.xaml
    ''' </summary>
    Partial Public Class MainWindow
        Inherits Window
        Public Sub New()
            InitializeComponent()
        End Sub
    End Class
End Namespace

MainWindow.xaml

<Window x:Class="Docking_Layout_TabGroups.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="MainWindow" Height="254" Width="593"
        xmlns:dxdo="http://schemas.devexpress.com/winfx/2008/xaml/docking"
        xmlns:dxcore="http://schemas.devexpress.com/winfx/2008/xaml/core"
        >
    <Grid>
        <dxdo:DockLayoutManager Margin="12" Name="dockManager1" 
                          dxcore:ThemeManager.ThemeName="Office2007Blue">
            <!--Root group-->
            <dxdo:LayoutGroup x:Name="rootGroup" Orientation="Horizontal" >

                <!--Layout group displaying children within tabs-->
                <dxdo:LayoutGroup x:Name="layoutGroup1" Orientation="Horizontal" GroupBorderStyle="Tabbed">
                    <dxdo:LayoutGroup Orientation="Vertical" Caption="Personal Info">
                        <dxdo:LayoutControlItem x:Name="itemFirstName" Caption="First Name" >
                            <TextBox />
                        </dxdo:LayoutControlItem>
                        <dxdo:LayoutControlItem x:Name="itemLastName" Caption="Last Name" >
                            <TextBox />
                        </dxdo:LayoutControlItem>
                    </dxdo:LayoutGroup>

                    <dxdo:LayoutGroup Orientation="Vertical" Caption="Phones">
                        <dxdo:LayoutControlItem x:Name="itemPhone" Caption="Phone" >
                            <TextBox/>
                        </dxdo:LayoutControlItem>
                    </dxdo:LayoutGroup>
                </dxdo:LayoutGroup>

                <dxdo:DocumentGroup>
                    <dxdo:DocumentPanel  Caption="Document 1">
                        <RichTextBox/>
                    </dxdo:DocumentPanel>
                </dxdo:DocumentGroup>
            </dxdo:LayoutGroup>
        </dxdo:DockLayoutManager>
    </Grid>
</Window>

MainWindow.xaml.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Navigation;
using System.Windows.Shapes;

namespace Docking_Layout_TabGroups {
    /// <summary>
    /// Interaction logic for MainWindow.xaml
    /// </summary>
    public partial class MainWindow : Window {
        public MainWindow() {
            InitializeComponent();
        }
    }
}

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the GroupBorderStyle property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

wpf-dock-layout-manager-limit-layout-group-customization-at-runtime/CS/DXDockingForLayoutPurposes/MainWindow.xaml#L25

<dxd:DockLayoutManager>
    <dxd:LayoutGroup Name="generalLayoutGroup" GroupBorderStyle="GroupBox" ShowCaption="True" Caption="General" Orientation="Vertical">
        <dxd:LayoutControlItem Name="incidentNumber" Caption="Incident Number" VerticalAlignment="Top">

wpf-dock-layout-manager-place-layout-panel-into-the-layout-group-group-box-or-tabbed-group/VB/MainWindow.xaml#L10

<common:LayoutGroupEx Orientation="Vertical">
    <common:LayoutGroupEx GroupBorderStyle="Group" ShowCaption="True" Caption="Group">
        <dxd:LayoutPanel Caption="Panel1"/>

wpf-docklayoutmanager-build-a-layout-ui/VB/LayoutPanel_Content_Ex/Window1.xaml#L14

<dxdo:LayoutGroup Caption="Personal info"
                  GroupBorderStyle="GroupBox"
                  Orientation="Vertical"

how-to-customize-item-appearance-on-the-hidden-items-tab-in-the-customization-window-t345603/VB/ShowHiddenItemsAsTree/MainWindow.xaml#L39

<dxd:LayoutGroup Orientation="Vertical">
    <dxd:LayoutGroup GroupBorderStyle="GroupBox" Caption="Groupbox1" ShowCaption="True" Orientation="Vertical">
        <dxd:LayoutControlItem Caption="Item1">

wpf-dock-layout-manager-enable-the-tabbed-ui-for-a-layout-group/VB/Docking_Layout_TabGroups/MainWindow.xaml#L15

<!--Layout group displaying children within tabs-->
<dxdo:LayoutGroup x:Name="layoutGroup1" Orientation="Horizontal" GroupBorderStyle="Tabbed">
    <dxdo:LayoutGroup Orientation="Vertical" Caption="Personal Info">