WinUI3中禁用TreeView为何未渲染TreeViewItem禁用样式？

问题原因 #

1. WinUI3 TreeView的默认实现中，IsEnabled状态不会自动传递给子级TreeViewItem，TreeView自身禁用仅会阻止交互，但不会影响子项的视觉状态。
2. TreeViewItem的默认视觉状态触发器仅监听自身的IsEnabled属性，不关联父TreeView的状态。直接绑定TreeViewItem的IsEnabled到TreeView时，若未指定正确的绑定源（比如忽略了TreeViewItem的DataContext是数据项而非TreeView），绑定会失效。

解决方法 #

方法一：修正TreeViewItem的IsEnabled绑定 #

由于TreeViewItem的DataContext默认是绑定的数据项，需通过RelativeSource指定父TreeView作为绑定源：

<!-- 直接声明TreeViewItem时 -->
<TreeViewItem IsEnabled="{Binding IsEnabled, RelativeSource={RelativeSource AncestorType=TreeView}}"
              Header="示例项"/>

<!-- 使用ItemTemplate时 -->
<TreeView.ItemTemplate>
    <DataTemplate>
        <TreeViewItem IsEnabled="{Binding IsEnabled, RelativeSource={RelativeSource AncestorType=TreeView}}"
                      Header="{Binding Header}">
            <!-- 子项内容 -->
        </TreeViewItem>
    </DataTemplate>
</TreeView.ItemTemplate>

绑定生效后，TreeViewItem的IsEnabled会跟随父TreeView的状态，触发自身的Disabled视觉样式。

方法二：修改TreeViewItem的样式，监听父TreeView状态 #

提取TreeViewItem的默认样式，修改其Disabled状态的触发条件，让它同时响应自身或父TreeView的禁用状态：

1. 首先添加一个反转布尔值的转换器：

public class InverseBooleanConverter : IValueConverter
{
    public object Convert(object value, Type targetType, object parameter, string language)
    {
        return !(bool)value;
    }

    public object ConvertBack(object value, Type targetType, object parameter, string language)
    {
        return !(bool)value;
    }
}

2. 在XAML中引用转换器，并修改TreeViewItem的VisualState：

<Page.Resources>
    <local:InverseBooleanConverter x:Key="InverseBooleanConverter"/>
    <Style TargetType="TreeViewItem" BasedOn="{StaticResource TreeViewItemStyle}">
        <Setter Property="Template">
            <Setter.Value>
                <ControlTemplate TargetType="TreeViewItem">
                    <!-- 保留原模板结构，修改VisualStateGroups部分 -->
                    <VisualStateManager.VisualStateGroups>
                        <VisualStateGroup x:Name="CommonStates">
                            <VisualState x:Name="Normal"/>
                            <VisualState x:Name="PointerOver"/>
                            <VisualState x:Name="Pressed"/>
                            <VisualState x:Name="Disabled">
                                <VisualState.StateTriggers>
                                    <OrStateTrigger>
                                        <!-- 自身禁用时触发 -->
                                        <StateTrigger IsActive="{Binding IsEnabled, RelativeSource={RelativeSource Mode=Self}}"/>
                                        <!-- 父TreeView禁用时触发 -->
                                        <StateTrigger IsActive="{Binding IsEnabled, RelativeSource={RelativeSource AncestorType=TreeView}, Converter={StaticResource InverseBooleanConverter}}"/>
                                    </OrStateTrigger>
                                </VisualState.StateTriggers>
                                <VisualState.Setters>
                                    <Setter Target="ContentPresenter.Foreground" Value="{ThemeResource TreeViewItemForegroundDisabled}"/>
                                </VisualState.Setters>
                            </VisualState>
                        </VisualStateGroup>
                        <!-- 其他状态组保留 -->
                    </VisualStateManager.VisualStateGroups>
                </ControlTemplate>
            </Setter.Value>
        </Setter>
    </Style>
</Page.Resources>

这种方法无需修改TreeViewItem的IsEnabled属性，直接通过视觉状态触发器关联父容器的状态。

查看WinUI源码的关键点 #

要理解此问题，可查看microsoft-ui-xaml仓库中的以下内容：

1. TreeViewItem的默认样式：路径dev/controls/TreeView/TreeViewItem.xaml，重点看CommonStates中的Disabled状态触发器，默认仅监听自身IsEnabled，无父容器关联逻辑。
2. TreeView的默认模板：路径dev/controls/TreeView/TreeView.xaml，查看模板中是否有传递IsEnabled状态给子项的逻辑，默认无相关处理。
3. TreeView的代码逻辑：路径dev/controls/TreeView/TreeView.cs，检查IsEnabled属性变化时的处理逻辑，默认未实现自动同步子项状态的代码。

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