LayoutPanel Class

Represents a dock panel.

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

Declaration

C#
VB.NET

public class LayoutPanel :
    ContentItem,
    IGeneratorHost,
    IClosable

Public Class LayoutPanel
    Inherits ContentItem
    Implements IGeneratorHost,
               IClosable

The following members return LayoutPanel objects:

Remarks

The LayoutPanel object represents a regular dock panel:

LayoutPanel

Create a LayoutPanel

Layout panels can be displayed in the following states:

Side-by-side (vertically or horizontally) with other panels.

XAML

<dxdo:DockLayoutManager>
    <dxdo:LayoutGroup Caption="LayoutRoot">
        <dxdo:LayoutPanel Caption="Panel1"/>
        <dxdo:LayoutPanel Caption="Panel2"/>
        <dxdo:LayoutPanel Caption="Panel3"/>
    </dxdo:LayoutGroup>
</dxdo:DockLayoutManager>

LayoutPanels side-by-side with other LayoutPanels

Side-by-side (vertically or horizontally) with other dock objects. You should combine panels into a Layout Group to form this layout in code or XAML.

XAML

<dxdo:DockLayoutManager>
    <dxdo:LayoutGroup Caption="LayoutRoot">
        <dxdo:LayoutPanel Caption="Panel1"/>
        <dxdo:LayoutGroup Caption="LayoutGroup">
            <dxdo:LayoutPanel Caption="Panel2"/>
            <dxdo:LayoutPanel Caption="Panel3"/>
        </dxdo:LayoutGroup>
    </dxdo:LayoutGroup>
</dxdo:DockLayoutManager>

LayoutPanels side-by-side with the LayoutGroup

Combined into a tab container.

XAML

<dxdo:DockLayoutManager>
    <dxdo:LayoutGroup Caption="LayoutRoot">
        <dxdo:TabbedGroup>
            <dxdo:LayoutPanel Caption="Panel1"/>
            <dxdo:LayoutPanel Caption="Panel2"/>
            <dxdo:LayoutPanel Caption="Panel3"/>
        </dxdo:TabbedGroup>
    </dxdo:LayoutGroup>
</dxdo:DockLayoutManager>

LayoutPanels in the Tabbed Group

Combined into a Float Group.

XAML

<dxdo:DockLayoutManager>
    <dxdo:DockLayoutManager.FloatGroups>
        <dxdo:FloatGroup Caption="FloatGroup">
            <dxdo:LayoutPanel Caption="Panel1"/>
            <dxdo:LayoutPanel Caption="Panel2"/>
            <dxdo:LayoutPanel Caption="Panel3"/>
        </dxdo:FloatGroup>
  </dxdo:DockLayoutManager.FloatGroups>
</dxdo:DockLayoutManager>

LayoutPanels in the Float Group

Combined into a Auto-Hide Group.

XAML

<dxdo:DockLayoutManager>
    <dxdo:DockLayoutManager.AutoHideGroups>
        <dxdo:AutoHideGroup Caption="AutoHideGroup">
            <dxdo:LayoutPanel Caption="Panel1"/>
            <dxdo:LayoutPanel Caption="Panel2"/>
            <dxdo:LayoutPanel Caption="Panel3"/>
        </dxdo:AutoHideGroup>
    </dxdo:DockLayoutManager.AutoHideGroups>
</dxdo:DockLayoutManager>

LayoutPanels in the Audo-Hide Group

Use the ContentItem.Content property to specify a content for a panel. In XAML, an element added between the start and end LayoutPanel tags is used to initialize the ContentItem.Content property.

Note

Do not combine dock and layout items within a single group.
Do not combine groups containing dock items with groups containing layout items. If you need to arrange layout items next to dock items, add the layout items into a dock panel (a LayoutPanel object).
Do not use dock items outside the DockLayoutManager control.

Note

Do not place a DocumentPanel into a LayoutPanel, and vice versa.

Refer to the Layout (Dock) Panels topic for more information.

Refer to the How to create a simple layout of dock panes topic for more information on how to create various kinds of panels.

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

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.

how-to-animate-a-layout-panel-by-its-width-height-e3643/CS/Q357154/MainWindow.xaml#L13

</ResourceDictionary.MergedDictionaries>
<Style TargetType="dxd:LayoutPanel">
    <Setter Property="ShowCaption" Value="False" />

wpf-dock-layout-manager-pin-unpin-a-layout-panel/CS/CreateAutoHiddenPanels/Window1.xaml#L24

<dxdo:AutoHideGroup x:Name="auotHideGroup" DockType="Right">
    <dxdo:LayoutPanel x:Name="paneProperties" Caption="Properties" ItemWidth="150">
        <RichTextBox />

wpf-dock-layout-manager-save-and-restore-the-dock-layout-managers-layout/CS/MainWindow.xaml#L16

<dxdo:LayoutGroup Name="root">
    <dxdo:LayoutPanel Name="panel1" Caption="Panel1" ItemWidth="3*">
        <dxg:GridControl Name="grid">

wpf-dock-layout-manager-build-a-layout-similar-to-visual-studio/VB/MainWindow.xaml#L22

<dxdo:TabbedGroup ItemHeight="150">
    <dxdo:LayoutPanel Caption="Error List"/>
    <dxdo:LayoutPanel Caption="Output"/>

wpf-docklayoutmanager-create-a-complex-dock-ui/VB/CreateLayoutGroups/Window1.xaml#L9

<dxdo:LayoutGroup x:Name="LayoutGroup2" Orientation="Horizontal" ItemHeight="1.5*">
    <dxdo:LayoutPanel x:Name="paneToolbox" Caption="Toolbox" />
    <dxdo:LayoutPanel x:Name="paneFindResults" Caption="Find Results" />