WPF TextBlock的详细使用教程

最新推荐文章于 2025-06-20 17:36:27 发布

原创最新推荐文章于 2025-06-20 17:36:27 发布 · 2.1k 阅读

20 ·

CC 4.0 BY-SA版权

文章标签：

#wpf

WPF 专栏收录该内容

91 篇文章

订阅专栏

WPF（Windows Presentation Foundation）的TextBlock是一个用于显示少量文本的控件，支持简单的文本渲染，并且提供了基本的文本格式化和布局功能。以下是TextBlock的详细使用教程，包括基本的用法、属性设置和文本格式化。

1. 基本用法

<TextBlock Text="Hello, World!" />

这是最简单的TextBlock用法，直接设置Text属性显示文本。

2. 常用属性

TextBlock有一些常用属性可以控制文本的显示和布局。

Text: 显示的文本内容。
FontSize: 设置文本的字体大小。
FontFamily: 设置文本的字体。
FontWeight: 设置文本的粗细（如Normal、Bold）。
FontStyle: 设置字体样式（如Normal、Italic）。
Foreground: 设置文本的颜色（例如使用Brushes类）。
TextWrapping: 控制文本是否换行，值包括Wrap、NoWrap。
TextAlignment: 控制文本的对齐方式（如Left、Center、Right）。
Padding: 设置文本的内边距。
LineHeight: 设置行高。

例如：

<TextBlock Text="Welcome to WPF!"
           FontSize="16"
           FontFamily="Arial"
           FontWeight="Bold"
           FontStyle="Italic"
           Foreground="Blue"
           TextWrapping="Wrap"
           TextAlignment="Center"
           Padding="10"
           LineHeight="24"/>

在这里插入图片描述

3. 多行文本

为了显示多行文本，可以使用换行符或设置TextWrapping="Wrap"。

<TextBlock Text="This is line 1.&#x0a;This is line 2." 
           TextWrapping="Wrap" />

或者：

    <TextBlock Text="This is line 1.   This is line 2." Width="100"  TextWrapping="Wrap" />

在这里插入图片描述

4. 内嵌文本格式化

TextBlock支持使用<Run>、<Bold>、<Italic>等元素在文本中嵌入格式化信息。例如：

<TextBlock>
    <Run Text="This is " />
    <Bold>bold</Bold>
    <Run Text=" and this is " />
    <Italic>italic</Italic>
    <Run Text="." />
</TextBlock>

在这里插入图片描述

5. 在`TextBlock`中显示链接

TextBlock中也可以显示超链接，使用<Hyperlink>元素。

<TextBlock>
    Please visit <Hyperlink NavigateUri="http://www.example.com">our website</Hyperlink>.
</TextBlock>

在这里插入图片描述

6. 文本对齐和布局

TextAlignment: 控制文本在水平方向上的对齐方式（Left、Center、Right、Justify）。
TextTrimming: 控制文本被截断的方式，通常用于文本过长的情况。可选值为None、CharacterEllipsis（显示省略号）等。

<TextBlock Text="This is a long text that will be trimmed."
           TextTrimming="CharacterEllipsis"
           Width="200" />

在这里插入图片描述

7. 控制文本的行间距

可以通过LineHeight和LineStackingStrategy属性控制行与行之间的间距。

<TextBlock Text="First Line.&#x0a;Second Line."
           LineHeight="30"
           LineStackingStrategy="BlockLineHeight" />

在这里插入图片描述

8. 高级用法：绑定和动态更新文本

TextBlock的文本内容可以通过数据绑定动态更新。例如：

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

你需要在后台代码中设置一个绑定的数据上下文，并确保SomeTextProperty是一个实现了INotifyPropertyChanged接口的属性。

9. 在代码中操作`TextBlock`

你也可以在C#代码中操作TextBlock：

TextBlock myTextBlock = new TextBlock();
myTextBlock.Text = "Hello from code!";
myTextBlock.FontSize = 14;
myTextBlock.Foreground = new SolidColorBrush(Colors.Red);