WPF - DockPanel

更新于 2024/4/7 21:14:00

DockPanel 定义一个区域，用于水平或垂直排列子元素的相对位置。借助 DockPanel，您可以使用 Dock 属性轻松地将子元素停靠到顶部、底部、右侧、左侧和中心。

使用 LastChildFill 属性，最后一个子元素将填充剩余空间，无论为该元素设置任何其他停靠值如何。 DockPanel类的层次继承如下 −

DockPanel 常用属性

下面给出的是 DockPanel 最常用的属性。

Sr. No.	属性和描述
1	Background 获取或设置填充面板内容区域的Brush。（继承自Panel）
2	Children 获取此面板的子元素的 UIElementCollection。（继承自Panel。）
3	Dock 获取或设置一个值，该值指示子元素在父 DockPanel 中的位置。
4	Height 获取或设置元素的建议高度。（继承自FrameworkElement。）
5	ItemHeight 获取或设置一个值，该值指定 WrapPanel 中包含的所有项目的高度。
6	ItemWidth 获取或设置一个值，该值指定 WrapPanel 中包含的所有项目的宽度。
7	LastChildFill 获取或设置一个值，该值指示 DockPanel 中的最后一个子元素是否延伸以填充剩余的可用空间。
8	LogicalChildren 获取一个可以迭代此Panel 元素的逻辑子元素的枚举器。（继承自Panel。）
9	LogicalOrientation 面板的方向（如果面板仅支持单个维度的布局）。（继承自Panel。）
10	Margin 获取或设置元素的外边距。（继承自FrameworkElement。）
11	Name 获取或设置元素的标识名称。该名称提供了一个引用，以便代码隐藏（例如事件处理程序代码）可以在 XAML 处理器处理期间构造标记元素后引用该标记元素。（继承自FrameworkElement。）
12	Orientation 获取或设置一个值，该值指定子内容的排列维度。
13	Parent 获取该元素的逻辑父元素。（继承自FrameworkElement。）
14	Resources 获取或设置本地定义的资源字典。（继承自FrameworkElement。）
15	Style 获取或设置此元素在呈现时使用的样式。（继承自FrameworkElement。）
16	Width 获取或设置元素的宽度。（继承自 FrameworkElement。）

DockPanel 常用方法

下面给出了 DockPanel 最常用的方法。

Sr. No.	方法及描述
1	GetDock 获取指定 UIElement 的 Dock 附加属性的值。
2	SetDock 将 Dock 附加属性的值设置为指定元素。

Sr. No.

方法及描述

GetDock

获取指定 UIElement 的 Dock 附加属性的值。

SetDock

将 Dock 附加属性的值设置为指定元素。

示例

以下示例演示如何将子元素添加到 DockPanel 中。以下 XAML 实现在 DockPanel 内创建按钮。

<Window x:Class = "WPFDockPanel.MainWindow" 
   xmlns = "http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
   xmlns:x = "http://schemas.microsoft.com/winfx/2006/xaml" 
   xmlns:d = "http://schemas.microsoft.com/expression/blend/2008" 
   xmlns:mc = "http://schemas.openxmlformats.org/markup-compatibility/2006" 
   xmlns:local = "clr-namespace:WPFDockPanel" 
   mc:Ignorable = "d" Title = "MainWindow" Height = "350" Width = "604">
	
   <Grid> 
      <DockPanel LastChildFill = "True"> 
         <Button Content = "Top" DockPanel.Dock = "Top" Click = "Click_Me" /> 
         <Button Content = "Bottom" DockPanel.Dock = "Bottom" Click = "Click_Me" />
         <Button Content = "Left" Click = "Click_Me" /> 
         <Button Content = "Right" DockPanel.Dock = "Right" Click = "Click_Me" /> 
         <Button Content = "Center" Click = "Click_Me" /> 
      </DockPanel> 
   </Grid> 
	
</Window>

这是事件的C# 实现。

using System.Windows; 
using System.Windows.Controls;
  
namespace WPFDockPanel { 
   /// <summary> 
      /// Interaction logic for MainWindow.xaml 
   /// </summary> 
	
   public partial class MainWindow : Window { 
	
      public MainWindow() { 
         InitializeComponent(); 
      } 
		
      private void Click_Me(object sender, RoutedEventArgs e) { 
         Button btn = sender as Button; 
         string str = btn.Content.ToString() + " button clicked"; 
         MessageBox.Show(str); 
      }  
		
   } 
}

编译并执行上述代码时，将显示以下输出 −