为何我的TreeViewItem文本无法换行？求换行实现方法（附XAML代码）

为什么TreeViewItem文本不会换行？ #

主要有三个核心原因：

• 默认模板限制：TreeViewItem默认的Header模板里，用于显示文本的TextBlock默认设置了TextWrapping="NoWrap"，不会自动换行。
• 内容对齐问题：TreeViewItem的HorizontalContentAlignment默认值是Left，这导致文本容器只会适应文本自身的宽度，不会占满TreeView的可用空间，自然没有换行的触发条件。
• 横向滚动优先级：TreeView本身自带横向ScrollViewer，当内容宽度超出控件宽度时，默认会显示横向滚动条，让内容横向展开，而不是换行。

实现换行效果的具体方案 #

下面是完整的XAML示例，包含两种实现方式：单个Item设置和全局样式设置。

方式1：针对单个TreeViewItem设置（适合局部调整）

<Window x:Class="WpfAppTestScrollViewBehavior.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:WpfAppTestScrollViewBehavior"
        mc:Ignorable="d"
        Title="MainWindow" Height="450" Width="800">
    <Grid>
        <!-- 禁用横向滚动，让内容优先换行 -->
        <TreeView ScrollViewer.HorizontalScrollBarVisibility="Disabled">
            <!-- 设置横向内容对齐为Stretch，让文本容器占满可用宽度 -->
            <TreeViewItem Header="这是一段非常非常长的文本，需要换行显示测试TreeViewItem的换行效果，看看能不能自动换行"
                          HorizontalContentAlignment="Stretch">
                <!-- 自定义HeaderTemplate，启用文本换行 -->
                <TreeViewItem.HeaderTemplate>
                    <DataTemplate>
                        <TextBlock Text="{Binding}" TextWrapping="Wrap" />
                    </DataTemplate>
                </TreeViewItem.HeaderTemplate>
                <TreeViewItem Header="子项1：同样很长的文本内容，测试子节点的换行效果，确保所有层级都能正常换行"
                              HorizontalContentAlignment="Stretch">
                    <TreeViewItem.HeaderTemplate>
                        <DataTemplate>
                            <TextBlock Text="{Binding}" TextWrapping="Wrap" />
                        </DataTemplate>
                    </TreeViewItem.HeaderTemplate>
                </TreeViewItem>
            </TreeViewItem>
        </TreeView>
    </Grid>
</Window>

方式2：全局样式设置（适合所有TreeViewItem生效）

如果希望所有TreeViewItem都自动换行，可以定义全局样式，避免重复设置：

<Window x:Class="WpfAppTestScrollViewBehavior.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:WpfAppTestScrollViewBehavior"
        mc:Ignorable="d"
        Title="MainWindow" Height="450" Width="800">
    <Window.Resources>
        <!-- 全局TreeViewItem样式 -->
        <Style TargetType="TreeViewItem">
            <Setter Property="HorizontalContentAlignment" Value="Stretch" />
            <Setter Property="HeaderTemplate">
                <Setter.Value>
                    <DataTemplate>
                        <TextBlock Text="{Binding}" TextWrapping="Wrap" />
                    </DataTemplate>
                </Setter.Value>
            </Setter>
        </Style>
    </Window.Resources>
    <Grid>
        <TreeView ScrollViewer.HorizontalScrollBarVisibility="Disabled">
            <TreeViewItem Header="这是一段非常非常长的文本，需要换行显示测试TreeViewItem的换行效果，看看能不能自动换行">
                <TreeViewItem Header="子项1：同样很长的文本内容，测试子节点的换行效果，确保所有层级都能正常换行" />
            </TreeViewItem>
        </TreeView>
    </Grid>
</Window>

关键步骤说明 #

1. 禁用横向滚动：通过ScrollViewer.HorizontalScrollBarVisibility="Disabled"关闭TreeView的横向滚动，强制内容在超出宽度时换行。
2. 设置横向内容对齐：HorizontalContentAlignment="Stretch"让TreeViewItem的内容容器占满TreeView的可用宽度，为换行提供足够的空间。
3. 启用文本换行：在HeaderTemplate中使用TextWrapping="Wrap"的TextBlock，替代默认的不换行文本容器。

内容的提问来源于stack exchange，提问作者Eric Ouellet