EmptySpaceItem Class

Adds whitespace to a UI. The whitespace is a rectangle object with invisible bounds that has its own height and width.

Namespace: DevExpress.Xpf.Docking

Assembly: DevExpress.Xpf.Docking.v24.2.dll

NuGet Package: DevExpress.Wpf.Docking

Declaration

C#

public class EmptySpaceItem :
    FixedItem

VB.NET

Public Class EmptySpaceItem
    Inherits FixedItem

Remarks

Unlike the Margin property, an EmptySpaceItem object is not bound to a specific UI element.

The following code sample adds EmptySpaceItem to the application’s layout:

XAML

<Window ...
    xmlns:dxdo="http://schemas.devexpress.com/winfx/2008/xaml/docking">
    <Grid>
        <dxdo:DockLayoutManager>
            <dxdo:LayoutGroup>
                <dxdo:LayoutGroup Orientation="Vertical">
                    <dxdo:LayoutGroup>
                        <dxdo:LabelItem Caption="First Name"/>
                        <dxdo:LayoutControlItem>
                            <TextBox Text="Arnold"/>
                        </dxdo:LayoutControlItem>
                    </dxdo:LayoutGroup>
                    <dxdo:LayoutGroup>
                        <dxdo:LabelItem Caption="Last Name"/>
                        <dxdo:LayoutControlItem>
                            <TextBox Text="Schwartz"/>
                        </dxdo:LayoutControlItem>
                    </dxdo:LayoutGroup>
                    <dxdo:EmptySpaceItem ItemHeight="20"/>
                    <dxdo:LayoutGroup>
                        <dxdo:LabelItem Caption="Department"/>
                        <dxdo:LayoutControlItem>
                            <TextBox Text="Engineering"/>
                        </dxdo:LayoutControlItem>
                    </dxdo:LayoutGroup>
                    <!-- ... -->
                </dxdo:LayoutGroup>
            </dxdo:LayoutGroup>
        </dxdo:DockLayoutManager>
    </Grid>
<Window>

The image below demonstrates a selected EmptySpaceItem when Customization Mode is enabled.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the EmptySpaceItem 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.

XAML

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

    </dxd:LayoutControlItem>
    <dxd:EmptySpaceItem></dxd:EmptySpaceItem>
</dxd:LayoutGroup>

Inheritance

Show 11 items

Object

DispatcherObject

DependencyObject

Visual

UIElement

FrameworkElement

Control

DevExpress.Xpf.Docking.psvFrameworkElement

BaseLayoutItem

FixedItem

EmptySpaceItem