如何为WinUI的ToggleButton设置全局KeyboardAccelerator？

问题背景 #

我有一个绑定了KeyboardAccelerator的ToggleButton，按下B键可以切换按钮状态，但该快捷键仅在窗口获得焦点时生效。需要实现无论窗口是否聚焦，都能触发按钮切换的全局快捷键。

当前使用的XAML代码：

<ToggleButton Content="Click me!">
    <ToggleButton.KeyboardAccelerators>
        <KeyboardAccelerator Key="B" />
    </ToggleButton.KeyboardAccelerators>
</ToggleButton>

效果演示：

项目为TemplateStudio创建的WinUI（C#）项目，查阅官方文档未找到直接设置全局KeyboardAccelerator的方法。

实现方案 #

WinUI自带的KeyboardAccelerator仅支持应用内聚焦窗口触发，要实现系统级全局快捷键，需借助Win32 API的RegisterHotKey和UnregisterHotKey函数，步骤如下：

1. 导入Win32 API声明 #

在项目中添加P/Invoke代码，用于调用系统热键相关函数：

using System.Runtime.InteropServices;

public static class Win32HotKeyHelper
{
    [DllImport("user32.dll", SetLastError = true)]
    public static extern bool RegisterHotKey(IntPtr hWnd, int id, uint fsModifiers, uint vk);

    [DllImport("user32.dll", SetLastError = true)]
    public static extern bool UnregisterHotKey(IntPtr hWnd, int id);

    // 自定义唯一热键ID
    public const int GlobalHotKeyId = 1001;
    // 无修饰键的标识
    public const uint ModifierNone = 0x0000;
}

2. 注册全局热键 #

在窗口加载完成后，获取窗口句柄并注册热键：

private void MainWindow_Loaded(object sender, RoutedEventArgs e)
{
    // 获取当前WinUI窗口的句柄
    var windowHandle = WinRT.Interop.WindowNative.GetWindowHandle(this);
    // 注册全局热键：无修饰键，触发键为B（虚拟键码0x42）
    Win32HotKeyHelper.RegisterHotKey(windowHandle, Win32HotKeyHelper.GlobalHotKeyId, Win32HotKeyHelper.ModifierNone, 0x42);
}

3. 监听热键触发消息 #

重写窗口的消息处理逻辑，捕获热键触发的系统消息：

protected override void OnSourceInitialized(EventArgs e)
{
    base.OnSourceInitialized(e);
    // 绑定窗口消息钩子
    if (PresentationSource.FromVisual(this) is HwndSource hwndSource)
    {
        hwndSource.AddHook(WindowMessageHandler);
    }
}

private IntPtr WindowMessageHandler(IntPtr hwnd, int msg, IntPtr wParam, IntPtr lParam, ref bool handled)
{
    const int WM_HOTKEY = 0x0312;
    if (msg == WM_HOTKEY)
    {
        int hotKeyId = wParam.ToInt32();
        if (hotKeyId == Win32HotKeyHelper.GlobalHotKeyId)
        {
            // 切换ToggleButton的状态（需给按钮命名为MyToggleButton）
            MyToggleButton.IsChecked = !MyToggleButton.IsChecked;
            handled = true;
        }
    }
    return IntPtr.Zero;
}

提示：需在XAML中将ToggleButton的x:Name设置为MyToggleButton，或者通过数据绑定、控件查找等方式获取按钮实例。

4. 注销全局热键 #

在窗口关闭时注销热键，避免系统资源泄漏：

private void MainWindow_Closed(object sender, WindowEventArgs e)
{
    var windowHandle = WinRT.Interop.WindowNative.GetWindowHandle(this);
    Win32HotKeyHelper.UnregisterHotKey(windowHandle, Win32HotKeyHelper.GlobalHotKeyId);
}

额外注意 #

• 全局热键容易与系统或其他应用的热键冲突，建议搭配修饰键使用（比如Ctrl+Alt+B），只需修改fsModifiers参数：例如ModifierCtrl = 0x0002、ModifierAlt = 0x0001，多个修饰键用|组合，如ModifierCtrl | ModifierAlt。
• 若需注册多个全局热键，需为每个热键定义唯一的GlobalHotKeyId。

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