wpf TextBlock 控件如何根据内容换行?

在 WPF 中,让 TextBlock 根据内容自动换行,核心是设置 TextWrapping="Wrap",并配合宽度约束。

1. 核心属性:TextWrapping

TextWrapping 是枚举,控制换行行为:

  • NoWrap(默认):不换行,超出部分被截断
  • Wrap自动换行(按单词 / 空格换行,长单词可能被截断)
  • WrapWithOverflow:换行,但允许长单词超出边界不截断

2. XAML 示例(自动换行)

复制代码
<!-- 固定宽度,自动换行 -->
<TextBlock 
    Text="这是一段很长很长的文本内容,会根据 TextBlock 的宽度自动换行显示。"
    Width="200"
    TextWrapping="Wrap" />

<!-- 自适应父容器宽度,自动换行 -->
<Grid Width="300">
    <TextBlock 
        Text="自适应容器宽度,内容超出自动换行。"
        TextWrapping="Wrap"
        HorizontalAlignment="Stretch" />
</Grid>

3. C# 后台代码设置

复制代码
TextBlock textBlock = new TextBlock();
textBlock.Text = "后台代码设置自动换行的长文本...";
textBlock.Width = 200;
textBlock.TextWrapping = TextWrapping.Wrap; // 关键

4. 手动强制换行(固定换行)

  • XAML:用 &#x000A;<LineBreak/>

    <TextBlock TextWrapping="Wrap"> 第一行文本 第二行文本 <LineBreak/> 第三行 </TextBlock>
  • C#:用 \nEnvironment.NewLine

    textBlock.Text = "第一行\n第二行\r\n第三行";

5. 常见问题:换行不生效

  • 未设宽度 :TextBlock 必须有 Width/MaxWidth 或父容器限制宽度
  • 父容器允许无限宽 (如 ScrollViewer 内):需给 TextBlock 设 MaxWidth
  • 长英文 / URL :默认按空格换行,无空格时用 TextTrimming 裁剪或加软连字符 &shy;

6. 进阶:TextTrimming(省略号)

配合换行,超长末尾显示 ...

复制代码
<TextBlock 
    Text="非常长的文本..."
    Width="200"
    TextWrapping="Wrap"
    TextTrimming="CharacterEllipsis" />

总结 :自动换行 = TextWrapping="Wrap" + 宽度约束

相关推荐
WPF工业上位机20 小时前
匠心研智造,同心赴新程-WPF硬件通讯之串口&Socket
wpf
爱炸薯条的小朋友1 天前
C#由窗体原子表溢出造成的软件闪退,根本原因补充
开发语言·c#·wpf
晚风一隅2 天前
阿里云盘古存储系统:EB级分布式存储的架构革命与技术突破
wpf
步步为营DotNet2 天前
深挖.NET 11:.NET Aspire 在云原生应用状态管理的创新与实践
云原生·.net·wpf
He BianGu2 天前
【项目】WPF VisionMaster 4.0 项目介绍和开发文档
c#·wpf·流程图·开发文档·机器视觉·visionmaster
He BianGu2 天前
【笔记】在WPF中PriorityBinding的详细介绍
笔记·wpf
bugcome_com3 天前
WPF + Prism 技术指南与实战项目(一、自行搭建)
wpf·prism
她说彩礼65万4 天前
WPF Border
wpf
He BianGu4 天前
【笔记】在WPF中在IValueConverter 时“无法返回有效值该怎么做”
笔记·wpf
海兰4 天前
使用 OpenTelemetry 与 Elastic APM 追踪 MCP 服务器工具调用
运维·服务器·elasticsearch·wpf