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>
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() {
-
- DockPanel dcPanel = new DockPanel();
-
- Button TopRect = new Button();
- TopRect.Background = new SolidColorBrush(Colors.LightGreen);
- TopRect.Height = 50;
- TopRect.Content = "Top";
-
- DockPanel.SetDock(TopRect, Dock.Top);
-
- dcPanel.Children.Add(TopRect);
-
- Button LeftRect = new Button();
- LeftRect.Background = new SolidColorBrush(Colors.LightBlue);
- LeftRect.Width = 50;
- LeftRect.Content = "Left";
-
- DockPanel.SetDock(LeftRect, Dock.Left);
-
- dcPanel.Children.Add(LeftRect);
-
- Button RightRect = new Button();
- RightRect.Background = new SolidColorBrush(Colors.LightSalmon);
- RightRect.Width = 50;
- RightRect.Content = "Right";
-
- DockPanel.SetDock(RightRect, Dock.Right);
-
- dcPanel.Children.Add(RightRect);
-
- Button BottomRect = new Button();
- BottomRect.Background = new SolidColorBrush(Colors.LightCyan);
- BottomRect.Height = 50;
- BottomRect.Content = "Bottom";
-
- DockPanel.SetDock(BottomRect, Dock.Bottom);
-
- dcPanel.Children.Add(BottomRect);
-
- Button FillRect = new Button();
- BottomRect.Background = new SolidColorBrush(Colors.LightGray);
-
- dcPanel.Children.Add(FillRect);
- RootWindow.Content = dcPanel;
- }
Listing 1