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

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

1. TextBlock控件的基本属性

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

1.1 内容属性

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

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

1.2 布局属性

FontSize：设置字体的大小。

<TextBlock FontSize="20"/>
1

FontWeight：设置字体的粗细。

<TextBlock FontWeight="Bold"/>
1

FontFamily：设置字体的类型。

<TextBlock FontFamily="Arial"/>
1

Foreground：设置文本的颜色。

<TextBlock Foreground="Red"/>
1

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

<TextBlock Background="Yellow"/>
1

1.3 外观属性

Margin：设置文本边距。

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

Padding：设置文本内部填充。

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

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

<TextBlock TextWrapping="Wrap"/>
1

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

<TextBlock TextTrimming="CharacterEllipsis"/>
1

LineHeight：设置文本的行高。

<TextBlock LineHeight="1.5"/>
1

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

<TextBlock FontStretch="ExtraCondensed"/>
1

1.4 数据绑定属性

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

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

2. TextBlock控件的基本事件

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

2.1 输入事件

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

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

2.2 鼠标事件

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

<TextBlock MouseLeftButtonDown="TextBlock_MouseLeftButtonDown"/>
1

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

<TextBlock MouseLeftButtonUp="TextBlock_MouseLeftButtonUp"/>
1

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

<TextBlock MouseEnter="TextBlock_MouseEnter"/>
1

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

<TextBlock MouseLeave="TextBlock_MouseLeave"/>
1

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>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

在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;
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

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

总结

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