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/>

    第一行文本 第二行文本 第三行
  • C#:用 \n 或 Environment.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" + 宽度约束

相关推荐
samble3 天前
从零搭建半导体设备上位机(十二):参数设置页,表单校验、范围校验与配方联动
wpf·数据校验·validationrule
samble11 天前
从零搭建半导体设备上位机(九):拖拽与交互,Adorner、DragDrop 与晶圆拖放信息
wpf·拖拽·adorner
郝学胜-神的一滴12 天前
AI 编程智能体 27:吃透MCP通信机制
人工智能·python·langchain·wpf·numpy·scikit-learn
波力海苔夹心脆67513 天前
C# WPF 资源字典详解:ResourceDictionary、MergedDictionaries 与自定义控件案例
开发语言·c#·wpf·入门教程·resource·资源字典
陈仓主教13 天前
# WPF CheckBox 控件详解与使用—WPF 中的控件(6)--复选框控件(CheckBox)
wpf
光泽雨15 天前
WPF 音视频四大核心方案对比
wpf·音视频
浪扼飞舟16 天前
WPF(数据绑定)
wpf
samble17 天前
从零搭建半导体设备上位机(四):单实例、启动流程与配置文件,App 里那 526 行到底在干什么
wpf·配置文件·单实例
浪扼飞舟17 天前
WPF(控件的继承树、内容控件、布局控件)
wpf
avi911120 天前
电影开源Jevdo - 源码介绍(vue版)没有android 和 没有wpf
android·wpf·框架·数据爬虫·meego·电影管理