DockPanel in WPF


A Dock Panel is used to dock child elements in the left, right, top, and bottom positions of the relative elements. The position of child elements is determined by the Dock property of the respective child elements and the relative order of those child elements. The default value of Dock property is left. The Dock property is of type Dock enumeration that has Left, Right, Top, and Bottom values.

The code listed in below creates a DockPanel with five Button elements. Four buttons are docked and the last one has no docking set that fills the entire remaining area.

<DockPanel Name="dcPanel">        

    <Button Name="TopRect" DockPanel.Dock="Top" Background="LightGreen"

            Height="50" Content="Top"/>

    <Button Name="LeftRect" DockPanel.Dock="Left" Background="LightBlue"

            Width="50" Content="Left"/>

    <Button Name="RightRect" DockPanel.Dock="Right" Background="LightSalmon"

            Width="50" Content="Right"/>

    <Button Name="BottomRect" DockPanel.Dock="Bottom" Background="LightCyan"

            Height="50"/>

    <Button Name="Fill" Background="LightGray" />

</DockPanel>

DockPanelImg1.gif

Figure 1

The DockPanel class in WPF represents a DockPanel control.  The code listed below creates a Dock Panel dynamically, add five Button controls to it, and sets their docking properties by using SetDock method.   The output of Listing generates Figure 1.

 

private void CreateADockPanelDynamically()

{

    // Create a DockPanel

    DockPanel dcPanel = new DockPanel();

 

    // Create a button

    Button TopRect = new Button();

    TopRect.Background = new SolidColorBrush(Colors.LightGreen);

    TopRect.Height = 50;

    TopRect.Content = "Top";

    // Dock button to top

    DockPanel.SetDock(TopRect, Dock.Top);

    // Add docked button to DockPanel

    dcPanel.Children.Add(TopRect);

 

    // Create a button

    Button LeftRect = new Button();

    LeftRect.Background = new SolidColorBrush(Colors.LightBlue);

    LeftRect.Width = 50;

    LeftRect.Content = "Left";

    // Dock button to left

    DockPanel.SetDock(LeftRect, Dock.Left);

    // Add docked button to DockPanel

    dcPanel.Children.Add(LeftRect);

 

    // Create a button

    Button RightRect = new Button();

    RightRect.Background = new SolidColorBrush(Colors.LightSalmon);

    RightRect.Width = 50;

    RightRect.Content = "Right";

    // Dock button to left

    DockPanel.SetDock(RightRect, Dock.Right);

    // Add docked button to DockPanel

    dcPanel.Children.Add(RightRect);

 

    // Create a button

    Button BottomRect = new Button();

    BottomRect.Background = new SolidColorBrush(Colors.LightCyan);

    BottomRect.Height = 50;

    BottomRect.Content = "Bottom";

    // Dock button to left

    DockPanel.SetDock(BottomRect, Dock.Bottom);

    // Add docked button to DockPanel

    dcPanel.Children.Add(BottomRect);

 

    // Create a fill button

    Button FillRect = new Button();

    BottomRect.Background = new SolidColorBrush(Colors.LightGray);

 

    // Add docked button to DockPanel

    dcPanel.Children.Add(FillRect);

 

    RootWindow.Content = dcPanel;

 

}

Listing 1

erver'>
Up Next
    Ebook Download
    View all
    Learn
    View all