WinUI 3页面多SplitView首次打开自动关闭问题求助

常见原因 #

• 焦点冲突与系统交互逻辑：WinUI 3的SplitView内置默认焦点处理逻辑，当页面存在多个该控件时，首次加载阶段系统可能自动调整焦点，误判用户点击了面板外部，触发面板关闭行为。
• 绑定属性初始化时机偏差：即便绑定了独立的ObservableProperty，若属性初始化晚于SplitView控件加载完成时间，控件会先使用默认值，后续属性更新时可能引发状态意外反转；或绑定模式设置不当（比如误用TwoWay但未同步初始值）。
• 布局与PanePlacement冲突：多个SplitView的面板放置位置（如都设为Left/Right）可能导致布局计算异常，触发控件内部状态重置逻辑，进而关闭面板。

解决方法 #

1. 延迟设置面板打开状态，避开初始化焦点干扰 #

在页面Loaded事件中延迟设置IsPaneOpen，确保控件完全初始化后再调整状态：

private void Page_Loaded(object sender, RoutedEventArgs e)
{
    DispatcherQueue.TryEnqueue(DispatcherQueuePriority.Low, () =>
    {
        SplitView1IsPaneOpen = true;
        SplitView2IsPaneOpen = true;
        // 其他SplitView的属性设置
    });
}

2. 规范绑定属性的初始化与绑定模式 #

• 在ViewModel构造函数中提前初始化绑定属性：

public class YourViewModel : ObservableObject
{
    public YourViewModel()
    {
        SplitView1IsPaneOpen = true;
        SplitView2IsPaneOpen = true;
    }

    private bool _splitView1IsPaneOpen;
    public bool SplitView1IsPaneOpen
    {
        get => _splitView1IsPaneOpen;
        set => SetProperty(ref _splitView1IsPaneOpen, value);
    }

    private bool _splitView2IsPaneOpen;
    public bool SplitView2IsPaneOpen
    {
        get => _splitView2IsPaneOpen;
        set => SetProperty(ref _splitView2IsPaneOpen, value);
    }
}

• XAML中显式指定绑定模式为TwoWay，避免歧义：

<SplitView IsPaneOpen="{x:Bind ViewModel.SplitView1IsPaneOpen, Mode=TwoWay}" ...>
    <!-- 控件内容 -->
</SplitView>
<SplitView IsPaneOpen="{x:Bind ViewModel.SplitView2IsPaneOpen, Mode=TwoWay}" ...>
    <!-- 控件内容 -->
</SplitView>

3. 调整布局避免面板位置冲突 #

将多个SplitView的PanePlacement设为不同值（如一个Left、一个Right），或用Grid等布局容器分隔控件，确保面板有独立显示空间：

<Grid>
    <SplitView PanePlacement="Left" IsPaneOpen="{x:Bind ViewModel.LeftPaneOpen, Mode=TwoWay}" />
    <SplitView PanePlacement="Right" IsPaneOpen="{x:Bind ViewModel.RightPaneOpen, Mode=TwoWay}" />
</Grid>

4. 手动拦截意外关闭行为 #

处理SplitView的PaneClosing事件，根据业务逻辑阻止不必要的关闭：

private void SplitView_PaneClosing(SplitView sender, SplitViewPaneClosingEventArgs args)
{
    // 示例：首次加载时阻止面板关闭
    if (IsFirstLoad)
    {
        args.Cancel = true;
        IsFirstLoad = false;
    }
}

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