WPF如何将父窗口未处理击键转发给未聚焦的KeyBinding子控件

核心逻辑根源 #

WPF的InputBindings触发链路是从当前键盘焦点元素开始，沿可视化树向根元素方向冒泡匹配的。当焦点从子UserControl移到父窗口的其他控件上时，匹配链路就会停在父窗口层级，自然不会触发子UserControl上预先定义的按键绑定。要实现父窗口的路由转发，不需要复杂的击键模拟，只要抓住KeyBinding本质是命令包装的特性即可。

推荐实现方案（零副作用、无焦点抢占） #

直接在父窗口上挂隧道阶段的按键预览事件做逻辑路由即可，全程不需要模拟系统级击键，也不会打断用户当前的焦点状态。

第一步：添加可视化树查找辅助方法 #

因为ContentControl是通过DataTemplate映射生成的UserControl视图，其Content属性绑定的是ViewModel实例，拿不到实际的View元素，需要通过可视化树查找承载的UserControl：

private T FindVisualChild<T>(DependencyObject parent) where T : DependencyObject
{
    if (parent == null) return null;
    for (int i = 0; i < VisualTreeHelper.GetChildrenCount(parent); i++)
    {
        var child = VisualTreeHelper.GetChild(parent, i);
        if (child is T typedChild) return typedChild;
        var recursiveResult = FindVisualChild<T>(child);
        if (recursiveResult != null) return recursiveResult;
    }
    return null;
}

第二步：在父窗口中挂载PreviewKeyDown路由事件 #

利用隧道阶段的事件优先级——PreviewKeyDown会最先在根窗口触发，此时可以先判断按键是否已被父窗口自身的绑定处理，没处理的就转发给目标子控件：

private void wndSession_PreviewKeyDown(object sender, KeyEventArgs e)
{
    // 已被上层处理的按键直接跳过，避免冲突
    if (e.Handled) return;

    // 获取当前ContentControl下承载的活动UserControl实例
    var activeChildView = FindVisualChild<UserControl>(contentControl);
    if (activeChildView == null) return;

    // 遍历子控件上定义的所有按键绑定，匹配当前按下的按键
    foreach (InputBinding binding in activeChildView.InputBindings)
    {
        if (binding is not KeyBinding keyBinding) continue;
        
        // 同时匹配按键本身和修饰键（Ctrl/Shift/Alt）
        if (keyBinding.Key == e.Key && keyBinding.Modifiers == Keyboard.Modifiers)
        {
            // 检查命令是否处于可执行状态
            if (keyBinding.Command != null && keyBinding.Command.CanExecute(keyBinding.CommandParameter))
            {
                // 直接执行绑定关联的命令，和用户聚焦时按按键的效果完全一致
                keyBinding.Command.Execute(keyBinding.CommandParameter);
                e.Handled = true;
                return;
            }
        }
    }
}

把事件绑定到XAML对应的Window元素上即可：

<Window x:Class="YourNamespace.wndSession"
        PreviewKeyDown="wndSession_PreviewKeyDown">
    <!-- 原有窗口内容 -->
</Window>

方案优势 #

• 完全符合要求的路由规则：父窗口自身的KeyBinding优先级永远最高，只有父窗口没处理的按键才会转发给子控件，不存在多控件同时响应的冲突
• 无焦点副作用：不会强行把焦点从用户当前交互的父窗口控件上切走，完全不打断用户操作流
• 强解耦：所有按键逻辑还是保留在各个子UserControl的InputBindings配置里，后续新增/修改子控件的按键绑定时，完全不需要改动父窗口的路由代码
• 规避了模拟击键的常见坑：不需要调用系统API发消息、不需要挂载全局键盘Hook，不存在输入框误触、消息队列错乱的问题

注意事项 #

• 一定要用PreviewKeyDown而不是普通的KeyDown：普通的KeyDown是冒泡事件，等触发到Window层级时，按键已经被中间的其他控件处理过了，会漏匹配
• 遍历子控件绑定的时候不要硬编码按键值：直接读取UserControl已经定义好的InputBindings，保证和聚焦状态下的触发逻辑完全一致
• 转发命令的时候不要修改当前焦点状态：如果在转发时强行把焦点切回UserControl，用户在父窗口输入框打字时的交互会被打断，体验反而变差
• 如果需要支持嵌套在UserControl内部的子元素上的KeyBinding，只要在遍历环节加一层递归，把控件树里所有元素的InputBindings都纳入匹配范围即可，核心逻辑保持不变
• 不推荐使用系统级模拟击键的实现方案：这类方案通常会带来焦点强制切换、输入框误收按键、跨进程消息错乱等问题，而且会绕开WPF本身的命令路由校验逻辑，出现和用户手动按按键不一致的响应结果

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