可以根據Github拉取示例程序運行
GitHub程序演示地址（點擊直達）
也可以在本文資源中下載

1. 引言

在WPF應用程序開發中，Label控件是最基礎的UI元素之一，用于顯示文本和其他內容。作為內容展示的基本組件，Label控件不僅提供了簡單的文本顯示功能，還能通過豐富的自定義選項創建出各種視覺效果。本文將深入解析WPF中Label控件的特性、用法以及高級應用，幫助開發者全面理解并充分利用這一基礎控件。

與其他UI框架中的標簽控件相比，WPF的Label控件具有更強的靈活性和更豐富的功能。通過XAML聲明式編程和WPF強大的樣式系統，Label可以實現從簡單文本展示到復雜內容呈現的各種需求。

本文將從Label控件的基礎屬性開始，逐步深入到樣式定制、內容設置、布局控制以及與其他控件的交互等方面，為讀者提供全面的Label控件使用指南。

2. Label控件基礎

2.1 類繼承結構

Label控件繼承自ContentControl，可以包含任何類型的內容。在類繼承層次上，Label的位置如下：

2.2 Label類定義

在.NET中，Label類的基本定義如下：

public class Label : ContentControl
{// 構造函數public Label();// 依賴屬性public static readonly DependencyProperty TargetProperty;  // 定義標簽關聯的目標控件// 屬性public UIElement Target { get; set; }  // 獲取或設置標簽關聯的目標控件，通常用于訪問鍵功能// 方法protected override void OnInitialized(EventArgs e);  // 初始化時調用protected override AutomationPeer OnCreateAutomationPeer();  // 創建自動化對等體用于輔助功能// 其他成員...
}

3. Label控件的核心屬性

3.1 Content屬性

由于Label繼承自ContentControl，它擁有Content屬性，可以設置為任何對象，包括字符串、圖像、面板等：

<!-- 簡單文本標簽 -->
<Label Content="用戶名：" /><!-- 復雜內容標簽 -->
<Label><StackPanel Orientation="Horizontal"><Image Source="/Images/user_icon.png" Width="16" Height="16" Margin="0,0,5,0"/><TextBlock Text="用戶名："/></StackPanel>
</Label>

在C#代碼中設置：

// 文本內容
myLabel.Content = "用戶名：";// 復雜內容
StackPanel panel = new StackPanel { Orientation = Orientation.Horizontal };  // 創建水平方向的StackPanel作為標簽內容容器
panel.Children.Add(new Image 
{ Source = new BitmapImage(new Uri("/Images/user_icon.png", UriKind.Relative)),  // 設置圖像源（相對路徑）Width = 16,      // 設置圖像寬度為16像素Height = 16,     // 設置圖像高度為16像素Margin = new Thickness(0, 0, 5, 0)  // 設置圖像右側邊距為5像素，使圖像與文本有間隔
});
panel.Children.Add(new TextBlock { Text = "用戶名：" });  // 添加文本塊作為標簽的文字部分
myLabel.Content = panel;  // 將整個面板設置為標簽的內容

3.2 Target屬性

Target屬性是Label特有的，用于將標簽與其他控件關聯起來。當標簽中定義了訪問鍵（使用下劃線_字符），并且設置了Target屬性，按下Alt+訪問鍵會將焦點移動到目標控件：

<Label Content="_用戶名：" Target="{Binding ElementName=txtUsername}" />
<TextBox x:Name="txtUsername" />

// 在代碼中設置Target
Label usernameLabel = new Label();
usernameLabel.Content = "_u用戶名：";  // 下劃線表示'u'是訪問鍵
usernameLabel.Target = txtUsername;   // 設置目標為用戶名文本框

Target屬性使Label成為一個可以通過鍵盤快速訪問關聯控件的工具，這對于提高表單的可訪問性和用戶體驗非常重要。

3.3 其他常用屬性

除了上述特有屬性外，Label還繼承了許多來自父類的重要屬性：

屬性名	描述	示例
Background	設置標簽背景	<Label Background="LightBlue" />
Foreground	設置標簽前景（通常是文本顏色）	<Label Foreground="Navy" />
FontSize	設置標簽文本大小	<Label FontSize="14" />
FontWeight	設置文本粗細	<Label FontWeight="Bold" />
FontFamily	設置字體	<Label FontFamily="Segoe UI" />
Padding	設置標簽內容的內邊距	<Label Padding="10,5" />
Margin	設置標簽的外邊距	<Label Margin="5" />
HorizontalAlignment	設置標簽在容器中的水平對齊方式	<Label HorizontalAlignment="Center" />
VerticalAlignment	設置標簽在容器中的垂直對齊方式	<Label VerticalAlignment="Center" />
HorizontalContentAlignment	設置標簽內容的水平對齊方式	<Label HorizontalContentAlignment="Right" />
VerticalContentAlignment	設置標簽內容的垂直對齊方式	<Label VerticalContentAlignment="Top" />
Width/Height	設置標簽的寬度/高度	<Label Width="100" Height="30" />
IsEnabled	設置標簽是否啟用	<Label IsEnabled="False" />
Visibility	設置標簽的可見性	<Label Visibility="Collapsed" />

4. 標簽樣式與模板自定義

WPF強大的樣式系統允許我們從簡單到復雜地自定義Label的外觀。

4.1 簡單樣式設置

最基本的樣式設置可以直接通過設置標簽屬性完成：

<Label Content="樣式化標簽" Background="LightYellow" Foreground="DarkGreen"FontWeight="Bold"FontStyle="Italic"Padding="10,5"BorderBrush="DarkGreen"BorderThickness="1" />

4.2 使用Style對象

更系統的方式是創建Style對象：

<Window.Resources><Style x:Key="GreenLabel" TargetType="Label"><Setter Property="Background" Value="LightYellow" /><Setter Property="Foreground" Value="DarkGreen" /><Setter Property="FontWeight" Value="Bold" /><Setter Property="Padding" Value="10,5" /><Setter Property="BorderBrush" Value="DarkGreen" /><Setter Property="BorderThickness" Value="1" /></Style>
</Window.Resources><Label Content="樣式化標簽" Style="{StaticResource GreenLabel}" />

在C#中動態應用樣式：

Style greenLabelStyle = (Style)FindResource("GreenLabel");  // 從資源字典中查找命名為"GreenLabel"的樣式
myLabel.Style = greenLabelStyle;  // 將樣式應用到標簽控件

4.3 觸發器使用

觸發器允許標簽在不同狀態下有不同的外觀：

<Style x:Key="AnimatedLabel" TargetType="Label"><Setter Property="Background" Value="LightYellow" /><Setter Property="Foreground" Value="DarkGreen" /><Setter Property="FontWeight" Value="Normal" /><Setter Property="Padding" Value="10,5" /><Style.Triggers><Trigger Property="IsMouseOver" Value="True"><Setter Property="Background" Value="LightGreen" /><Setter Property="Foreground" Value="DarkBlue" /><Setter Property="FontWeight" Value="Bold" /></Trigger><Trigger Property="IsEnabled" Value="False"><Setter Property="Opacity" Value="0.5" /><Setter Property="Foreground" Value="Gray" /></Trigger></Style.Triggers>
</Style>

4.4 使用ControlTemplate完全自定義

要徹底改變標簽的外觀，我們需要使用ControlTemplate：

<Style x:Key="FancyLabel" TargetType="Label"><Setter Property="Template"><Setter.Value><ControlTemplate TargetType="Label"><Border CornerRadius="5" BorderThickness="1" BorderBrush="#CCCCCC"Background="{TemplateBinding Background}"><Grid><Grid.RowDefinitions><RowDefinition Height="Auto"/><RowDefinition Height="Auto"/></Grid.RowDefinitions><Border Grid.Row="0" Background="#E0E0E0" Padding="5,2"><TextBlock Text="{TemplateBinding Tag}" FontSize="10" Foreground="Gray"/></Border><ContentPresenter Grid.Row="1" Margin="{TemplateBinding Padding}"HorizontalAlignment="{TemplateBinding HorizontalContentAlignment}"VerticalAlignment="{TemplateBinding VerticalContentAlignment}"/></Grid></Border><ControlTemplate.Triggers><Trigger Property="IsMouseOver" Value="True"><Setter Property="BorderBrush" Value="#999999"/></Trigger></ControlTemplate.Triggers></ControlTemplate></Setter.Value></Setter>
</Style>

上面的代碼創建了一個帶有標題欄的花式標簽模板，標題內容來自Tag屬性，主要內容使用ContentPresenter顯示。

使用這個模板的標簽示例：

<Label Content="詳細信息" Tag="信息" Style="{StaticResource FancyLabel}" Background="White"Padding="10,5" />

5. Label與表單控件交互

Label控件最常見的應用場景是與表單控件配合使用，例如TextBox、ComboBox等。

5.1 基本關聯

最簡單的關聯方式是通過布局來實現視覺上的關聯：

<Grid><Grid.ColumnDefinitions><ColumnDefinition Width="Auto"/><ColumnDefinition Width="*"/></Grid.ColumnDefinitions><Grid.RowDefinitions><RowDefinition Height="Auto"/><RowDefinition Height="Auto"/><RowDefinition Height="Auto"/></Grid.RowDefinitions><Label Grid.Row="0" Grid.Column="0" Content="用戶名:"/><TextBox Grid.Row="0" Grid.Column="1" Margin="5"/><Label Grid.Row="1" Grid.Column="0" Content="密碼:"/><PasswordBox Grid.Row="1" Grid.Column="1" Margin="5"/><Label Grid.Row="2" Grid.Column="0" Content="部門:"/><ComboBox Grid.Row="2" Grid.Column="1" Margin="5"/>
</Grid>

5.2 使用訪問鍵

通過Target屬性和訪問鍵，可以使用鍵盤快捷鍵直接激活相關控件：

<Grid><Grid.ColumnDefinitions><ColumnDefinition Width="Auto"/><ColumnDefinition Width="*"/></Grid.ColumnDefinitions><Grid.RowDefinitions><RowDefinition Height="Auto"/><RowDefinition Height="Auto"/><RowDefinition Height="Auto"/></Grid.RowDefinitions><Label Grid.Row="0" Grid.Column="0" Content="_U用戶名:" Target="{Binding ElementName=txtUsername}"/><TextBox x:Name="txtUsername" Grid.Row="0" Grid.Column="1" Margin="5"/><Label Grid.Row="1" Grid.Column="0" Content="_P密碼:" Target="{Binding ElementName=txtPassword}"/><PasswordBox x:Name="txtPassword" Grid.Row="1" Grid.Column="1" Margin="5"/><Label Grid.Row="2" Grid.Column="0" Content="_D部門:" Target="{Binding ElementName=cboDepartment}"/><ComboBox x:Name="cboDepartment" Grid.Row="2" Grid.Column="1" Margin="5"/>
</Grid>

在上面的示例中，用戶可以（或Alt+U）直接將焦點移動到用戶名文本框，（或Alt+P）移動到密碼框，（或Alt+D）移動到部門下拉框。

5.3 代碼實現Label與控件關聯

在代碼中通過C#實現Label與控件的關聯：

private void InitializeForm()
{// 創建用戶名標簽和文本框Label lblUsername = new Label();lblUsername.Content = "_U用戶名:";  // 下劃線定義訪問鍵TextBox txtUsername = new TextBox();lblUsername.Target = txtUsername;  // 設置標簽目標為文本框// 創建密碼標簽和密碼框Label lblPassword = new Label();lblPassword.Content = "_P密碼:";PasswordBox txtPassword = new PasswordBox();lblPassword.Target = txtPassword;// 將控件添加到布局容器Grid grid = new Grid();// 設置列定義grid.ColumnDefinitions.Add(new ColumnDefinition { Width = GridLength.Auto });grid.ColumnDefinitions.Add(new ColumnDefinition { Width = new GridLength(1, GridUnitType.Star) });// 設置行定義grid.RowDefinitions.Add(new RowDefinition { Height = GridLength.Auto });grid.RowDefinitions.Add(new RowDefinition { Height = GridLength.Auto });// 添加用戶名控件到GridGrid.SetRow(lblUsername, 0);Grid.SetColumn(lblUsername, 0);grid.Children.Add(lblUsername);Grid.SetRow(txtUsername, 0);Grid.SetColumn(txtUsername, 1);txtUsername.Margin = new Thickness(5);grid.Children.Add(txtUsername);// 添加密碼控件到GridGrid.SetRow(lblPassword, 1);Grid.SetColumn(lblPassword, 0);grid.Children.Add(lblPassword);Grid.SetRow(txtPassword, 1);Grid.SetColumn(txtPassword, 1);txtPassword.Margin = new Thickness(5);grid.Children.Add(txtPassword);// 將Grid添加到窗口內容this.Content = grid;
}

6. Label的高級用法

6.1 動態內容與綁定

Label控件可以通過數據綁定動態顯示內容：

<Label Content="{Binding UserName}" ContentStringFormat="用戶名: {0}"/>

在ViewModel中：

public class UserViewModel : INotifyPropertyChanged
{private string _userName;public string UserName{get { return _userName; }set {if (_userName != value){_userName = value;OnPropertyChanged(nameof(UserName));  // 通知UI該屬性已更改}}}public event PropertyChangedEventHandler PropertyChanged;protected void OnPropertyChanged(string propertyName){PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));  // 觸發屬性更改事件}
}

6.2 使用ContentStringFormat格式化顯示

ContentStringFormat屬性允許對顯示內容進行格式化：

<Label Content="{Binding Price}" ContentStringFormat="價格: {0:C}"/>

這將使Price值按貨幣格式顯示，例如"價格: ￥123.45"。

6.3 多語言支持

使用資源文件和綁定可以實現Label內容的多語言支持：

<Label Content="{Binding Source={StaticResource Resources}, Path=UsernameLabel}" />

在資源文件中定義不同語言的標簽內容：

<!-- 中文資源文件 -->
<system:String x:Key="UsernameLabel">用戶名:</system:String><!-- 英文資源文件 -->
<system:String x:Key="UsernameLabel">Username:</system:String>

6.4 創建自定義Label控件

為特定需求創建自定義Label控件：

public class RequiredFieldLabel : Label
{static RequiredFieldLabel(){// 覆蓋默認樣式DefaultStyleKeyProperty.OverrideMetadata(typeof(RequiredFieldLabel),new FrameworkPropertyMetadata(typeof(RequiredFieldLabel)));  // 設置默認樣式鍵類型為RequiredFieldLabel}public RequiredFieldLabel(){// 在構造函數中初始化this.Loaded += RequiredFieldLabel_Loaded;  // 注冊Loaded事件處理程序}private void RequiredFieldLabel_Loaded(object sender, RoutedEventArgs e){// 創建一個StackPanel來布局內容StackPanel panel = new StackPanel { Orientation = Orientation.Horizontal  // 設置為水平方向};// 保存原始內容object originalContent = this.Content;  // 保存標簽原有內容this.Content = null;  // 清除內容，將用新的面板替代// 添加原始內容到面板if (originalContent != null){ContentPresenter cp = new ContentPresenter{Content = originalContent  // 設置內容為標簽原有內容};panel.Children.Add(cp);  // 添加到面板中}// 添加紅色星號TextBlock asterisk = new TextBlock{Text = " *",  // 星號前有一個空格Foreground = Brushes.Red,  // 設置為紅色FontWeight = FontWeights.Bold,  // 設置為粗體VerticalAlignment = VerticalAlignment.Top  // 設置垂直對齊為頂部};panel.Children.Add(asterisk);  // 添加到面板中// 將新的面板設置為Label的內容this.Content = panel;  // 將整個面板設置為標簽的新內容}
}

在XAML中使用自定義Label：

<local:RequiredFieldLabel Content="用戶名"/>

然后在Generic.xaml中定義樣式：

<Style TargetType="{x:Type local:RequiredFieldLabel}"><Setter Property="Foreground" Value="Navy"/><Setter Property="FontWeight" Value="Bold"/>
</Style>

6.5 Label中使用HTML樣式的富文本

雖然Label不直接支持HTML，但可以使用TextBlock配合Run和其他內聯元素來實現類似富文本效果：

<Label><TextBlock><Run Text="普通文本" /><Run Text="粗體文本" FontWeight="Bold" /><Run Text="顏色文本" Foreground="Red" /><Hyperlink NavigateUri="https://www.example.com" RequestNavigate="Hyperlink_RequestNavigate">點擊鏈接</Hyperlink></TextBlock>
</Label>

對應的事件處理代碼：

private void Hyperlink_RequestNavigate(object sender, RequestNavigateEventArgs e)
{// 使用默認瀏覽器打開鏈接Process.Start(new ProcessStartInfo{FileName = e.Uri.AbsoluteUri,UseShellExecute = true});e.Handled = true;  // 標記事件已處理
}

7. Label控件的事件處理

雖然Label主要是顯示控件，但它仍然繼承了許多交互事件。

7.1 鼠標事件

Label支持標準的鼠標事件，可用于創建交互式標簽：

<Label Content="點擊查看詳情" MouseLeftButtonDown="Label_MouseLeftButtonDown"Cursor="Hand"Foreground="Blue"TextDecorations="Underline"/>

private void Label_MouseLeftButtonDown(object sender, MouseButtonEventArgs e)
{// 顯示詳細信息窗口或執行其他操作MessageBox.Show("這里是詳細信息內容");e.Handled = true;  // 標記事件已處理，防止事件繼續傳播
}

7.2 創建可點擊標簽

結合樣式和事件處理，可以創建類似超鏈接的可點擊標簽：

<Style x:Key="HyperlinkLabel" TargetType="Label"><Setter Property="Foreground" Value="Blue"/><Setter Property="Cursor" Value="Hand"/><Setter Property="TextDecorations" Value="Underline"/><Style.Triggers><Trigger Property="IsMouseOver" Value="True"><Setter Property="Foreground" Value="DarkBlue"/></Trigger></Style.Triggers>
</Style><Label Content="查看更多..." Style="{StaticResource HyperlinkLabel}" MouseLeftButtonDown="ViewMoreLabel_Click"/>

private void ViewMoreLabel_Click(object sender, MouseButtonEventArgs e)
{// 處理點擊事件// 例如導航到新頁面或打開對話框NavigationService.Navigate(new Uri("DetailsPage.xaml", UriKind.Relative));
}

7.3 使用Command綁定

在MVVM模式中，可以結合InputBindings使Label支持命令綁定：

<Label Content="執行操作" Cursor="Hand"><Label.InputBindings><MouseBinding MouseAction="LeftClick" Command="{Binding ExecuteCommand}"/></Label.InputBindings>
</Label>

在ViewModel中定義命令：

public class MainViewModel
{private ICommand _executeCommand;public ICommand ExecuteCommand{get{return _executeCommand ?? (_executeCommand = new RelayCommand(param => ExecuteAction(),param => CanExecuteAction()));}}private bool CanExecuteAction(){// 判斷命令是否可執行的邏輯return true;  // 總是可執行}private void ExecuteAction(){// 執行命令的具體邏輯MessageBox.Show("命令已執行");}
}

8. Label的輔助功能與可訪問性

8.1 基本可訪問性考慮

為提高應用程序的可訪問性，使用Label時應注意：

1. 確保Label與控件正確關聯（使用Target屬性）
2. 提供有意義的訪問鍵
3. 設置適當的AutomationProperties信息

<Label Content="_用戶名:" Target="{Binding ElementName=txtUsername}" AutomationProperties.HelpText="輸入您的登錄用戶名"AutomationProperties.Name="用戶名標簽"/>

8.2 使用Label提高表單可訪問性

結合Label的Target和訪問鍵功能，可以大幅提高表單的鍵盤可訪問性。在表單設計中，每個輸入控件都應有一個關聯的Label：

<StackPanel><Label Content="_名字:" Target="{Binding ElementName=txtFirstName}"/><TextBox x:Name="txtFirstName"/><Label Content="_姓氏:" Target="{Binding ElementName=txtLastName}"/><TextBox x:Name="txtLastName"/><Label Content="_電子郵件:" Target="{Binding ElementName=txtEmail}"/><TextBox x:Name="txtEmail"/><Label Content="_電話號碼:" Target="{Binding ElementName=txtPhone}"/><TextBox x:Name="txtPhone"/>
</StackPanel>

8.3 屏幕閱讀器優化(Win+Ctrl+Enter快捷鍵進入講述人模式)

為了使標簽與屏幕閱讀器更好地配合，應確保：

1. 使用明確的文本描述
2. 設置AutomationProperties.LabeledBy屬性關聯控件與標簽
3. 在適當情況下設置AccessText屬性

<Label x:Name="lblPhone" Content="電話號碼:"/>
<TextBox x:Name="txtPhone" AutomationProperties.LabeledBy="{Binding ElementName=lblPhone}"AutomationProperties.HelpText="請輸入您的聯系電話，格式為：XXX-XXXX-XXXX"/>

9. 性能和最佳實踐

9.1 Label性能優化

• 避免過度使用Label：當只需要顯示靜態文本時，考慮使用TextBlock代替Label，因為TextBlock更輕量。
• 適當緩存：對于復雜內容的Label，考慮使用BitmapCache提高性能。

<Label Content="復雜內容標簽" FontSize="18"><Label.CacheMode><BitmapCache /></Label.CacheMode>
</Label>

9.2 Label使用的最佳實踐

1. 選擇合適的控件：

   • 用于表單標簽時，使用Label并設置Target屬性
   • 僅顯示文本時，優先考慮TextBlock
   • 需要富文本時，考慮使用TextBlock配合多個Run或其他內聯元素

2. 恰當設置訪問鍵：選擇有意義且容易記住的字符作為訪問鍵。

3. 保持一致的樣式：在整個應用程序中保持標簽樣式的一致性。

4. 布局考慮：

   • 在表單中，使標簽與關聯控件的對齊方式保持一致
   • 對于右對齊的標簽，設置HorizontalContentAlignment="Right"
   • 表單內的所有標簽寬度應保持一致

5. 多語言支持：使用資源文件和綁定，避免硬編碼標簽內容。

9.3 Label與TextBlock選擇

Label和TextBlock是WPF中兩個可以顯示文本的控件，但它們有明顯區別：

特性	Label	TextBlock
繼承層次	ContentControl	FrameworkElement
內容類型	任意內容	僅文本和內聯元素
Target屬性	支持	不支持
訪問鍵	支持	不支持
模板支持	完全支持	有限支持
控件模型	完整控件	輕量級框架元素
性能	較重	輕量
適用場景	表單標簽、需要模板化的文本	靜態文本顯示、富文本顯示

選擇原則：

• 如果需要關聯到另一個控件（使用訪問鍵），選擇Label
• 如果只是顯示文本且不需要控件特性，選擇TextBlock
• 如果需要豐富的文本格式化，選擇TextBlock配合內聯元素

10. 總結

WPF中的Label控件是一個功能豐富的文本顯示組件，它不僅提供基本的文本顯示功能，還支持復雜內容、控件關聯和各種樣式定制。通過Label的Target屬性和訪問鍵功能，可以顯著提高應用程序的可訪問性和用戶體驗。

Label控件的主要特點和優勢包括：

1. 作為ContentControl，可以容納任何類型的內容
2. 通過Target屬性和訪問鍵提供鍵盤導航支持
3. 強大的樣式和模板自定義能力
4. 與其他表單控件的良好整合

通過本文的詳細介紹，我們了解了Label控件的核心屬性、樣式自定義、與表單控件的交互、高級用法以及性能優化等方面。掌握這些知識，可以幫助開發者在WPF應用程序中更有效地使用Label控件，創建出更友好、更易用的用戶界面。

學習資源

以下是一些深入學習WPF Label控件的優質資源：

1. 微軟官方文檔：Label類
2. WPF控件深入詳解系列 - MSDN
3. WPF UI設計最佳實踐指南
4. WPF示例代碼庫
5. WPF數據綁定深入解析
6. Stack Overflow上的WPF標簽問題集

通過系統學習和不斷實踐，你將能夠充分利用WPF Label控件的強大功能，創建出更加直觀、易用的用戶界面。