WinUI 3：如何将焦点设置到ContentDialog的按钮上

问题场景 #

使用C#开发WinUI 3桌面应用，实现了带「不再询问」复选框的删除确认ContentDialog。当前存在可用性问题：

• 通过键盘事件（如KeyUp）或KeyboardAccelerator触发对话框时，焦点默认落在第一个交互元素（复选框），而非已设置为默认按钮的CloseButton，且会显示焦点高亮矩形；
• 鼠标点击打开对话框时无此问题，疑似WinUI 3自身bug。

已尝试的无效方案：

• 在Opened事件中用VisualTreeHelper.GetOpenPopupsForXamlRoot()查找CloseButton，但导航层级复杂，FindName("CloseButton")无法定位目标控件；
• 给复选框添加GettingFocus事件并调用args.TryCancel()，但焦点会跳转到父窗口，不符合需求。

复现步骤 #

1. 在Visual Studio中创建「Blank App, Packaged (WinUI 3 in Desktop)」项目，命名为CheckboxTest；
2. 替换MainWindow.xaml代码：

<Window
    x:Class="CheckboxTest.MainWindow"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:CheckboxTest"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    mc:Ignorable="d"
    Title="ContentDialog Focus Test">

    <StackPanel Orientation="Horizontal" HorizontalAlignment="Center" VerticalAlignment="Center">
        <ContentDialog
            x:Name="DeleteConfirmationDialog"
            Title="Delete file"
            PrimaryButtonText="Move to Recycle Bin"
            CloseButtonText="Cancel"
            DefaultButton="Close">
            <StackPanel VerticalAlignment="Stretch" HorizontalAlignment="Stretch" Spacing="12">
                <TextBlock TextWrapping="Wrap" Text="Are you sure you want to move file 'somefile.jpg' to the Recycle Bin?" />
                <CheckBox x:Name="DeleteDontAskCheckbox" Content="Don't ask me again" />
            </StackPanel>
        </ContentDialog>
    </StackPanel>
</Window>

3. 替换MainWindow.xaml.cs代码：

using System;
using Microsoft.UI.Xaml;
using Microsoft.UI.Xaml.Controls;
using Microsoft.UI.Xaml.Input;

namespace CheckboxTest;

public sealed partial class MainWindow : Window
{
    public MainWindow()
    {
        this.InitializeComponent();
        this.Content.KeyUp += Content_KeyUp;
    }

    private async void Content_KeyUp(object sender, KeyRoutedEventArgs e)
    {
        if (e.Key == Windows.System.VirtualKey.Delete)
        {
            DeleteConfirmationDialog.XamlRoot = Content.XamlRoot;
            if (await DeleteConfirmationDialog.ShowAsync() == ContentDialogResult.Primary)
            {
                // 执行删除操作...
            }
        }
    }
}

4. 运行项目，按下Delete键，观察对话框焦点落在复选框上。

解决方案 #

方案1：通过VisualTreeHelper查找CloseButton并设置焦点 #

在ContentDialog的Opened事件中，遍历可视化树定位CloseButton，延迟设置焦点确保对话框完全加载：

1. 在XAML中给ContentDialog添加Opened事件：

<ContentDialog
    x:Name="DeleteConfirmationDialog"
    ...
    Opened="DeleteConfirmationDialog_Opened">

2. 在代码后台实现事件处理：

using Microsoft.UI.Xaml.Media;

private void DeleteConfirmationDialog_Opened(ContentDialog sender, ContentDialogOpenedEventArgs args)
{
    // 遍历可视化树查找CloseButton
    Button? closeButton = FindVisualChild<Button>(sender, button => button.Name == "CloseButton");
    if (closeButton != null)
    {
        // 延迟设置焦点，规避对话框加载时序问题
        _ = closeButton.Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, () =>
        {
            closeButton.Focus(Microsoft.UI.Xaml.FocusState.Programmatic);
        });
    }
}

// 通用可视化树查找工具方法
private T? FindVisualChild<T>(DependencyObject parent, Func<T, bool>? predicate = null) where T : DependencyObject
{
    for (int i = 0; i < VisualTreeHelper.GetChildrenCount(parent); i++)
    {
        DependencyObject child = VisualTreeHelper.GetChild(parent, i);
        if (child is T typedChild && (predicate == null || predicate(typedChild)))
        {
            return typedChild;
        }

        T? foundChild = FindVisualChild<T>(child, predicate);
        if (foundChild != null)
        {
            return foundChild;
        }
    }
    return null;
}

方案2：调整复选框的TabIndex #

ContentDialog的PrimaryButton默认TabIndex为0，CloseButton为1，将复选框的TabIndex设为更高值，让按钮优先获得焦点：

<CheckBox x:Name="DeleteDontAskCheckbox" Content="Don't ask me again" TabIndex="2" />

此方法实现简单，但依赖WinUI 3按钮的默认TabIndex值，若后续版本调整可能失效，建议优先使用方案1。

方案3：拦截复选框焦点并重定向到CloseButton #

在复选框的GettingFocus事件中，将焦点直接重定向到CloseButton：

1. 在XAML中添加事件绑定：

<CheckBox x:Name="DeleteDontAskCheckbox" Content="Don't ask me again" GettingFocus="DeleteDontAskCheckbox_GettingFocus" />

2. 实现事件处理：

private void DeleteDontAskCheckbox_GettingFocus(UIElement sender, GettingFocusEventArgs args)
{
    if (DeleteConfirmationDialog.IsOpen)
    {
        Button? closeButton = FindVisualChild<Button>(DeleteConfirmationDialog, b => b.Name == "CloseButton");
        if (closeButton != null)
        {
            args.TryRedirect(closeButton);
            args.Handled = true;
        }
    }
}

说明 #

方案1通过可视化树精准定位并延迟设置焦点，能稳定解决键盘触发时的焦点异常，绕过WinUI 3的默认焦点逻辑缺陷；方案2适合快速临时修复，方案3可作为补充拦截逻辑。

内容的提问来源于stack exchange，提问作者Dave R.