Back to Devexpress

EmptySpaceItem Class

wpf-devexpress-dot-xpf-dot-docking-753df083.md

latest4.4 KB
Original Source

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.v25.2.dll

NuGet Package : DevExpress.Wpf.Docking

Declaration

csharp
public class EmptySpaceItem :
    FixedItem
vb
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.

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.

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

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

See Also

EmptySpaceItem Members

Items

DevExpress.Xpf.Docking Namespace