WinUI 3应用中Frame内Page的键盘按键处理问题

我有如下XAML代码：

主窗口XAML

<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        x:Class="MainWindow"
        x:Name="_MainWindow">
    <Grid x:Name="_WindowMainGrid">
        <Frame x:Name="_MainFrame"/>
    </Grid>
</Window>

页面XAML

<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
      x:Class="GamePage"
      x:Name="_GamePage">
    <Grid x:Name="_PageMainGrid">
        <Image x:Name="_Image" SizeChanged="_Image_SizeChanged"/>
        <Grid x:Name="_WorkGrid">
            <!--Elements...-->
        </Grid>
    </Grid>
</Page>

我想在Frame承载的Page中处理键盘按键输入，写了如下事件代码：

_PageMainGrid.KeyDown += (s, e) =>
{
    if (args.Key == VirtualKey.Q)
    {
        // Action
    }
    if (args.Key == VirtualKey.W)
    {
        // Action
    }
};

但这段代码不生效，因为控件需要获取焦点才能处理键盘事件。我尝试用_PageMainGrid.Focus(FocusState.Keyboard);设置焦点，但方法始终返回false，焦点设置失败。请问该怎么解决？

1. 让Grid具备可聚焦属性 #

默认情况下Grid的Focusable属性为false，无法获取焦点。需要先开启这个属性：

• 在XAML中直接设置：

<Grid x:Name="_PageMainGrid" Focusable="True">
    <!-- 原有内容 -->
</Grid>

• 或在后台代码设置：

_PageMainGrid.Focusable = true;

2. 选择正确时机设置焦点 #

要等页面完全加载完成后再尝试设置焦点，比如在Page的Loaded事件中执行：

_GamePage.Loaded += (s, e) =>
{
    _PageMainGrid.Focus(FocusState.Programmatic);
};

这里用FocusState.Programmatic更合适，因为是代码主动触发的焦点设置，而非用户键盘操作触发。

3. 直接监听Page级别的键盘事件（推荐） #

如果不想依赖控件焦点，可以直接在Page本身绑定KeyDown事件，Page默认能捕获未被子控件拦截的键盘输入：

_GamePage.KeyDown += (s, e) =>
{
    if (e.Key == VirtualKey.Q)
    {
        // Action
    }
    if (e.Key == VirtualKey.W)
    {
        // Action
    }
};

这种方式无需设置任何焦点，只要页面处于激活状态就能响应按键。

4. 确保Frame完成导航后再操作 #

要确认Frame已经成功导航到GamePage，再绑定事件或设置焦点，比如在Frame的Navigated事件中处理：

_MainFrame.Navigated += (s, e) =>
{
    if (e.Content is GamePage gamePage)
    {
        // 绑定Page的KeyDown事件
        gamePage.KeyDown += GamePage_KeyDown;
        // 或设置Grid焦点
        gamePage.Loaded += (pageS, pageE) =>
        {
            gamePage._PageMainGrid.Focusable = true;
            gamePage._PageMainGrid.Focus(FocusState.Programmatic);
        };
    }
};

// 单独定义事件处理方法
private void GamePage_KeyDown(object sender, KeyRoutedEventArgs e)
{
    if (e.Key == VirtualKey.Q)
    {
        // Action
    }
    if (e.Key == VirtualKey.W)
    {
        // Action
    }
}

内容的提问来源于stack exchange，提问作者Георгий Попов