如何在C# WinForms全局热键绑定场景中检测Mouse 4/5按键按下

DevOps 小满

2026-9-30

解决方案

问题根因

你当前使用的KeyDown事件仅能响应键盘输入，Mouse 4（对应Keys.XButton2）、Mouse 5（对应Keys.XButton1）属于鼠标侧键输入，不会触发控件的键盘事件回调，因此无法在KeyDown中检测到侧键按下。

修复步骤

1. 添加鼠标按下事件监听侧键

给你的标签控件绑定MouseDown事件，仅在处于热键绑定状态（标签为活动控件）时处理侧键输入，逻辑和原有键盘热键绑定逻辑对齐：

private void leftClickHotkeyLbl_MouseDown(object sender, MouseEventArgs e)
{
    // 仅处于热键绑定状态时处理输入
    if (this.ActiveControl != leftClickHotkeyLbl) return;

    Keys detectedKey = Keys.None;
    if (e.Button == MouseButtons.XButton1)
    {
        detectedKey = Keys.XButton1;
        Console.WriteLine("Mouse 5 按下");
    }
    else if (e.Button == MouseButtons.XButton2)
    {
        detectedKey = Keys.XButton2;
        Console.WriteLine("Mouse 4 按下");
    }

    if (detectedKey != Keys.None)
    {
        // 复用原有热键绑定逻辑
        KeyBindManager.KeysConverter.UnregisterHotKey(this.Handle, (int)clickerHotkey);
        clickerHotkey = detectedKey;
        
        SetHotkey(clickerModifiers, clickerHotkey);
        leftClickHotkeyLbl.Text = $"[{KeyBindManager.KeysConverter.Convert(clickerHotkey)}]";
        this.ActiveControl = null;
    }
}