Bar.DockInfo Property

Contains information on the position where the bar is docked.

Namespace: DevExpress.Xpf.Bars

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

NuGet Package: DevExpress.Wpf.Core

Declaration

C#

public BarDockInfo DockInfo { get; set; }

VB.NET

Public Property DockInfo As BarDockInfo

Property Value

Type	Description
BarDockInfo	A BarDockInfo object.

Remarks

For a bar to be docked to the window, it must be associated with a specific bar container. Bar containers can be created implicitly or explicitly. Please refer to the BarContainerControl topic to learn more.

Example

This example shows how to manually create different types of bar containers:

1. A bar container used to display bars at the top of the window.
2. A float bar container (it’s created automatically when setting the Bar.DockInfo.ContainerType property to Floating),
3. A standalone bar container that can be freely positioned within the window.

The following image shows the result:

Xaml

<dxb:BarManager.Bars>
    <dxb:Bar x:Name="barFormat" Caption="Format">
        <dxb:Bar.DockInfo>
            <dxb:BarDockInfo ContainerType="Top" />
        </dxb:Bar.DockInfo>
        <dxb:Bar.ItemLinks>
            <dxb:BarCheckItemLink BarItemName="btnBold" />
            <dxb:BarCheckItemLink BarItemName="btnItalic" />
            <dxb:BarCheckItemLink BarItemName="btnUnderline" />
        </dxb:Bar.ItemLinks>
    </dxb:Bar>
    <!--Create a floating bar-->
    <dxb:Bar x:Name="barFont" Caption="Font">
        <dxb:Bar.DockInfo>
            <dxb:BarDockInfo ContainerType="Floating" FloatBarOffset="100,100" />
        </dxb:Bar.DockInfo>
        <dxb:Bar.ItemLinks>
            <dxb:BarButtonItemLink BarItemName="btnFont" />
        </dxb:Bar.ItemLinks>
    </dxb:Bar>
    <!--Create a bar displayed in the standalone container-->
    <dxb:Bar x:Name="barAlignment" Caption="Alignment">
        <dxb:Bar.DockInfo>
            <dxb:BarDockInfo ContainerName="StandaloneContainer" />
        </dxb:Bar.DockInfo>
        <dxb:Bar.ItemLinks>
            <dxb:BarCheckItemLink BarItemName="btnLeft" />
            <dxb:BarCheckItemLink BarItemName="btnCenter" />
            <dxb:BarCheckItemLink BarItemName="btnRight" />
            <dxb:BarCheckItemLink BarItemName="btnJustify" />
        </dxb:Bar.ItemLinks>
    </dxb:Bar>
</dxb:BarManager.Bars>
<!--Create containers to display bars-->
<DockPanel Name="dockPanel1" LastChildFill="False">
    <dxb:BarContainerControl x:Name="TopBarContainer"
                             ContainerType="Top"
                             DockPanel.Dock="Top" />
    <dxe:TextEdit Name="textBox"
                  Margin="8"
                  Width="300"
                  HorizontalAlignment="Left"
                  VerticalAlignment="Top"
                  DockPanel.Dock="Top"
                  EditValue="Sample text"
                  TextElement.FontSize="13" />
    <dxb:BarContainerControl x:Name="StandaloneContainer"
                             ContainerType="None"
                             DockPanel.Dock="Top"
                             Orientation="Horizontal" />
</DockPanel> 

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the DockInfo 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.

XAML

wpf-docklayoutmanager-load-an-external-window-or-usercontrol-into-a-documentpanel/CS/DocumentPanel_Content/MainWindow.xaml#L22

<dxb:Bar>
    <dxb:Bar.DockInfo>
        <dxb:BarDockInfo Row="1" />

wpf-data-grid-embed-a-richtextbox-into-grid-cells/CS/Window1.xaml#L19

<dxb:Bar UseWholeRow="True">
    <dxb:Bar.DockInfo>
        <dxb:BarDockInfo ContainerType="Top" />

wpf-bars-mvvm-generate-bars-from-view-model-collection/CS/DXSample/MainWindow.xaml#L63

<dxb:Bar Caption="{Binding Name}" ItemLinksSource="{Binding Items}" IsStatusBar="True">
    <dxb:Bar.DockInfo>
        <dxb:BarDockInfo ContainerType="Bottom"/>