如何在Flutter桌面应用中禁用Windows默认热键以自定义F10功能？

核心原因 #

F10是Windows默认的菜单栏激活热键，按下时系统会优先处理该消息，导致应用失去焦点，RawKeyDownEvent无法捕获。要解决这个问题，需要让应用优先接管系统热键的处理逻辑，阻止系统默认行为。

可行实现方法 #

1. 重写窗口消息处理（推荐，针对单个窗口）

通过拦截WM_SYSKEYDOWN消息（系统按键消息），在窗口级别优先处理F10等热键，阻止系统后续处理。

WinForms 示例：

protected override void WndProc(ref Message m)
{
    const int WM_SYSKEYDOWN = 0x0104;
    const int VK_F10 = 0x79;

    if (m.Msg == WM_SYSKEYDOWN && (int)m.WParam == VK_F10)
    {
        // 执行你的F10自定义操作
        // 例如：MyCustomF10Action();
        m.Result = IntPtr.Zero; // 标记消息已处理，阻止系统默认行为
        return;
    }
    base.WndProc(ref m);
}

WPF 示例：

public MainWindow()
{
    InitializeComponent();
    Loaded += OnWindowLoaded;
}

private void OnWindowLoaded(object sender, RoutedEventArgs e)
{
    if (PresentationSource.FromVisual(this) is HwndSource hwndSource)
    {
        hwndSource.AddHook(WndProc);
    }
}

private IntPtr WndProc(IntPtr hwnd, int msg, IntPtr wParam, IntPtr lParam, ref bool handled)
{
    const int WM_SYSKEYDOWN = 0x0104;
    const int VK_F10 = 0x79;

    if (msg == WM_SYSKEYDOWN && (int)wParam == VK_F10)
    {
        // 执行自定义操作
        handled = true; // 阻止消息传递给系统
        return IntPtr.Zero;
    }
    return IntPtr.Zero;
}

2. 全局低级别键盘钩子（拦截所有系统热键）

如果需要拦截全局范围内的系统热键（如Win键、Alt+Tab等），可以使用Windows API设置全局键盘钩子。

C# 示例：

private static IntPtr _hookId = IntPtr.Zero;
private delegate IntPtr LowLevelKeyboardProc(int nCode, IntPtr wParam, IntPtr lParam);
private static readonly LowLevelKeyboardProc _proc = HookCallback;

// 设置钩子
public static void SetGlobalHook()
{
    using (var curProcess = Process.GetCurrentProcess())
    using (var curModule = curProcess.MainModule)
    {
        _hookId = SetWindowsHookEx(WH_KEYBOARD_LL, _proc, GetModuleHandle(curModule.ModuleName), 0);
    }
}

// 移除钩子（应用退出时必须调用）
public static void Unhook()
{
    UnhookWindowsHookEx(_hookId);
}

private static IntPtr HookCallback(int nCode, IntPtr wParam, IntPtr lParam)
{
    const int WM_SYSKEYDOWN = 0x0104;
    // 可添加需要拦截的系统热键虚拟键码
    var blockedKeys = new[] { 0x79, 0x5B, 0x5C }; // F10、左Win、右Win

    if (nCode >= 0 && wParam == (IntPtr)WM_SYSKEYDOWN)
    {
        int vkCode = Marshal.ReadInt32(lParam);
        if (blockedKeys.Contains(vkCode))
        {
            return (IntPtr)1; // 返回1阻止消息传递给系统
        }
    }
    return CallNextHookEx(_hookId, nCode, wParam, lParam);
}

// 导入Windows API
[DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = true)]
private static extern IntPtr SetWindowsHookEx(int idHook, LowLevelKeyboardProc lpfn, IntPtr hMod, uint dwThreadId);

[DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = true)]
[return: MarshalAs(UnmanagedType.Bool)]
private static extern bool UnhookWindowsHookEx(IntPtr hhk);

[DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = true)]
private static extern IntPtr CallNextHookEx(IntPtr hhk, int nCode, IntPtr wParam, IntPtr lParam);

[DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = true)]
private static extern IntPtr GetModuleHandle(string lpModuleName);

private const int WH_KEYBOARD_LL = 13;

3. 禁用特定系统热键（如Win键）

对于部分可通过系统参数配置的热键（如Win键），可以使用SystemParametersInfo API直接禁用：

[DllImport("user32.dll", SetLastError = true)]
[return: MarshalAs(UnmanagedType.Bool)]
private static extern bool SystemParametersInfo(uint uiAction, uint uiParam, IntPtr pvParam, uint fWinIni);

private const int SPI_SETWINKEY = 0x0090;

// 禁用Win键
SystemParametersInfo(SPI_SETWINKEY, 1, IntPtr.Zero, 0);
// 恢复Win键
SystemParametersInfo(SPI_SETWINKEY, 0, IntPtr.Zero, 0);

注意事项 #

• 拦截系统热键可能影响用户的常规操作习惯，建议提供开关让用户恢复默认行为。
• 全局钩子需要在应用退出时调用Unhook释放资源，避免内存泄漏。
• 部分操作可能需要管理员权限（如全局钩子在高权限环境下运行）。

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