WinUI 3中TabIndex与箭头键导航结合的异常问题求助

问题根源 #

当给设置了TabFocusNavigation="Once"的容器指定TabIndex时，WinUI 3的焦点系统会将容器视为单个Tab停靠点，但内部控件的默认TabIndex会与容器的焦点规则冲突，导致焦点循环异常。直接在容器上设置TabIndex无法正确控制组间导航顺序，反而会破坏焦点链。

解决方案 #

1. 调整TabIndex的设置位置

移除所有容器（StackPanel）上的TabIndex，改为给每个组的第一个控件设置TabIndex，以此控制组间的Tab导航顺序。容器保留TabFocusNavigation="Once"和XYFocusKeyboardNavigation="Enabled"，确保组内用箭头键导航，组间用Tab键切换一次进入。

修正后的XAML代码：

<StackPanel
    HorizontalAlignment="Center"
    VerticalAlignment="Center"
    Orientation="Horizontal"
    TabFocusNavigation="Cycle">
    <!-- 组1：第一个按钮TabIndex=3，控制组顺序 -->
    <StackPanel
        HorizontalAlignment="Center"
        VerticalAlignment="Center"
        Orientation="Vertical"
        TabFocusNavigation="Once"
        XYFocusKeyboardNavigation="Enabled">
        <Button TabIndex="3">Click Me 1</Button>
        <Button>Click Me 2</Button>
        <Button>Click Me 3</Button>
        <Button>Click Me 4</Button>
    </StackPanel>
    <!-- 组2：第一个按钮TabIndex=2 -->
    <StackPanel
        HorizontalAlignment="Center"
        VerticalAlignment="Center"
        Orientation="Vertical"
        TabFocusNavigation="Once"
        XYFocusKeyboardNavigation="Enabled">
        <Button TabIndex="2">Click Me 5</Button>
        <Button>Click Me 6</Button>
        <Button>Click Me 7</Button>
        <Button>Click Me 8</Button>
    </StackPanel>
    <!-- 组3：第一个按钮TabIndex=1 -->
    <StackPanel
        HorizontalAlignment="Center"
        VerticalAlignment="Center"
        Orientation="Vertical"
        TabFocusNavigation="Once"
        XYFocusKeyboardNavigation="Enabled">
        <Button TabIndex="1">Click Me 9</Button>
        <Button>Click Me 10</Button>
        <Button>Click Me 11</Button>
        <Button>Click Me 12</Button>
    </StackPanel>
</StackPanel>

2. 修复焦点事件处理的COM异常

之前在GettingFocus事件中直接调用Focus()会干扰WinUI的焦点处理流程，导致COM异常。正确的做法是通过GettingFocusEventArgs的FocusedElement属性指定目标控件，无需手动调用Focus()。

修正后的后台代码：

private void StackPanel_OnGettingFocus(UIElement sender, GettingFocusEventArgs args)
{
    if (args.InputDevice == FocusInputDeviceKind.Keyboard && sender is Panel panel)
    {
        // 找到组内第一个可获得焦点的控件
        var targetControl = panel.Children.OfType<Control>()
            .FirstOrDefault(e => e.IsTabStop && e.IsEnabled);
        
        if (targetControl != null)
        {
            args.FocusedElement = targetControl;
            args.Handled = true;
        }
    }
}

同时需要给每个子StackPanel添加该事件绑定：

<StackPanel ... GettingFocus="StackPanel_OnGettingFocus">

效果验证 #

• 按Tab键时，焦点会按TabIndex顺序（组3→组2→组1）切换，每次进入组时焦点落在第一个按钮上，组内用箭头键可导航所有控件。
• 按Shift+Tab键时，焦点会反向按顺序切换，不会出现停滞问题。

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