当前位置：首页 > news >正文

【WPF应用5】WPF中的TextBlock控件：属性与事件详解及示例

news 2026/2/10 3:13:33

在WPF（Windows Presentation Foundation）开发中，TextBlock控件是一个常用的元素，用于显示静态或动态文本内容。它提供了丰富的属性和事件，使得开发者能够灵活地控制文本的显示样式和响应用户的交互行为。本文将详细介绍TextBlock控件的属性和事件，并提供一个完整的示例程序。

1. TextBlock控件的基本属性

TextBlock控件的属性可以分为布局属性、外观属性、内容属性和数据绑定属性等。以下是一些常用的属性及其用途：

1.1 内容属性

Text：设置或获取显示在TextBlock中的文本内容。

<TextBlock Text="这是一段文本"/>

1.2 布局属性

FontSize：设置字体的大小。

<TextBlock FontSize="20"/>

FontWeight：设置字体的粗细。

<TextBlock FontWeight="Bold"/>

FontFamily：设置字体的类型。

<TextBlock FontFamily="Arial"/>

Foreground：设置文本的颜色。

<TextBlock Foreground="Red"/>

Background：设置文本背景的颜色。

<TextBlock Background="Yellow"/>

1.3 外观属性

Margin：设置文本边距。

<TextBlock Margin="10,20,30,40"/>

Padding：设置文本内部填充。

<TextBlock Padding="5,10,15,20"/>

TextWrapping：设置文本的换行方式。

<TextBlock TextWrapping="Wrap"/>

TextTrimming：设置文本的裁剪方式。

<TextBlock TextTrimming="CharacterEllipsis"/>

LineHeight：设置文本的行高。

<TextBlock LineHeight="1.5"/>

FontStretch：设置字体的拉伸程度。

<TextBlock FontStretch="ExtraCondensed"/>

1.4 数据绑定属性

Text：可以使用数据绑定来设置文本内容。

<TextBlock Text="{Binding Path=TextProperty}"/>

2. TextBlock控件的基本事件

TextBlock控件触发的事件允许开发者响应用户的交互行为。以下是一些常用的事件及其用途：

2.1 输入事件

TextChanged：当文本内容发生变化时触发。

<TextBlock Text="{Binding Path=TextProperty}" TextChanged="TextBlock_TextChanged"/>

2.2 鼠标事件

MouseLeftButtonDown：当用户按下鼠标左键时触发。

<TextBlock MouseLeftButtonDown="TextBlock_MouseLeftButtonDown"/>

MouseLeftButtonUp：当用户释放鼠标左键时触发。

<TextBlock MouseLeftButtonUp="TextBlock_MouseLeftButtonUp"/>

MouseEnter：当鼠标指针进入TextBlock区域时触发。

<TextBlock MouseEnter="TextBlock_MouseEnter"/>

MouseLeave：当鼠标指针离开TextBlock区域时触发。

<TextBlock MouseLeave="TextBlock_MouseLeave"/>

3. 示例程序

以下是一个完整的示例程序，展示了如何将TextBlock控件添加到WPF应用程序中，并实现基本属性和事件的演示：

<Window x:Class="WpfApp.MainWindow"xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"Title="TextBlock Example" Height="200" Width="300"><StackPanel><TextBlock x:Name="myTextBlock"Text="这是一段文本"FontSize="20"FontWeight="Bold"FontFamily="Arial"Foreground="Red"Background="Yellow"Margin="10,20,30,40"Padding="5,10,15,20"TextWrapping="Wrap"TextTrimming="CharacterEllipsis"LineHeight="1.5"FontStretch="ExtraCondensed"MouseDown="MyTextBlock_MouseDown"MouseUp="MyTextBlock_MouseUp"MouseEnter="MyTextBlock_MouseEnter"MouseLeave="MyTextBlock_MouseLeave"GotFocus="MyTextBlock_GotFocus"LostFocus="MyTextBlock_LostFocus"></TextBlock></StackPanel>
</Window>

在C#代码背后，我们可以为TextBlock添加事件处理程序：

using System.Windows;namespace WpfApp
{public partial class MainWindow : Window{public MainWindow(){InitializeComponent();}private void MyTextBlock_TextChanged(object sender, TextChangedEventArgs e){// 处理文本变化事件MyTextBlock.Foreground = Brushes.Green;}private void MyTextBlock_MouseLeftButtonDown(object sender, MouseButtonEventArgs e){// 处理鼠标左键按下事件MyTextBlock.Foreground = Brushes.Green;}private void MyTextBlock_MouseLeftButtonUp(object sender, MouseButtonEventArgs e){// 处理鼠标左键释放事件MyTextBlock.Foreground = Brushes.Red;}private void MyTextBlock_MouseEnter(object sender, MouseEventArgs e){// 处理鼠标进入事件MyTextBlock.Background = Brushes.LightBlue;}private void MyTextBlock_MouseLeave(object sender, MouseEventArgs e){// 处理鼠标离开事件MyTextBlock.Background = Brushes.Yellow;}private void MyTextBlock_GotFocus(object sender, RoutedEventArgs e){// 处理获得焦点事件MyTextBlock.FontWeight = FontWeights.Bold;}private void MyTextBlock_LostFocus(object sender, RoutedEventArgs e){// 处理失去焦点事件MyTextBlock.FontWeight = FontWeights.Normal;}}
}

在这个示例中，我们创建了一个TextBlock控件，并设置了多种属性和响应了几个事件。当用户与TextBlock交互时，会触发相应的事件，并在事件处理程序中更改控件的属性，以展示如何使用这些事件来增强用户体验。

总结

TextBlock是WPF中一个简单但强大的控件，它允许开发者以声明式的方式显示和格式化文本。通过设置丰富的属性和响应事件，开发者可以创建出既美观又功能丰富的文本显示效果。掌握TextBlock的使用，对于构建现代且具有吸引力的WPF应用程序至关重要。