WPF - DockPanel

DockPanel 定義了一個區域，用於相對於彼此水平或垂直地排列子元素。使用 DockPanel，您可以使用Dock 屬性輕鬆地將子元素停靠到頂部、底部、右側、左側和中心。

DockPanel 類的層次繼承如下：

DockPanel 常用屬性

以下是 DockPanel 最常用的屬性。

序號	屬性及說明
1	Background 獲取或設定填充面板內容區域的 Brush。（繼承自 Panel）
2	Children 獲取此 Panel 的子元素的 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 最常用的方法。

序號	方法及說明
1	GetDock 獲取指定 UIElement 的 Dock 附加屬性的值。
2	SetDock 將 Dock 附加屬性的值設定為指定的元素。

序號

方法及說明

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); 
      }  
		
   } 
}

編譯並執行上述程式碼後，將顯示以下輸出：

單擊任何按鈕，它還會顯示一條訊息。例如，當您單擊位於中心的按鈕時，它將顯示以下訊息。

我們建議您執行上述示例程式碼並嘗試其其他屬性。

wpf_layouts.htm

列印頁面