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" + 宽度约束

相关推荐
bugcome_com18 小时前
WPF + Microsoft.ToolKit.Mvvm 技术指南与实战项目
microsoft·wpf
武藤一雄2 天前
WPF中逻辑树(Logical Tree)与可视化树(Visual Tree)到底是什么
microsoft·c#·.net·wpf·.netcore
炸炸鱼.2 天前
ELK 企业级日志分析系统完整部署手册
elk·wpf
Mr_pyx3 天前
微服务可观测性实战:分布式链路追踪从入门到精通
wpf
c#上位机4 天前
wpf附加事件
wpf
玖笙&4 天前
✨WPF编程进阶【9.1】:WPF资源完全指南(附源码)
c++·c#·wpf·visual studio
想你依然心痛4 天前
HarmonyOS 6(API 23)分布式实战:基于悬浮导航与沉浸光感的“光影协创“跨设备白板系统
分布式·wpf·harmonyos·悬浮导航·沉浸光感
c#上位机5 天前
wpf路由事件
wpf
nashane6 天前
HarmonyOS 鸿蒙 2026 全栈实战:从手势驱动到分布式数据落地的完整架构
wpf·harmony app
秋雨雁南飞6 天前
WPF 国际化(全球化)管理
wpf