如何在GLFW窗口获焦时捕获按键事件且不触发系统按键处理？

核心思路 #

GLFW默认按键回调仅能捕获窗口获焦时的普通按键输入，无法拦截系统级全局快捷键（如Windows的Alt+Tab/Win键、macOS的Command+Space）。要实现需求，需结合GLFW的平台原生窗口句柄，调用对应平台API拦截系统事件，同时阻止事件传递给系统，避免窗口失焦。

各平台具体实现 #

Windows平台 #

1. 获取GLFW窗口的HWND：

   HWND hwnd = glfwGetWin32Window(window);
   

2. 子类化窗口过程：
   替换窗口默认消息处理函数，拦截WM_KEYDOWN、WM_SYSKEYDOWN消息：
   • 识别Win键：判断wParam == VK_LWIN || wParam == VK_RWIN
   • 识别Alt+Tab：判断(GetKeyState(VK_MENU) & 0x8000) && wParam == VK_TAB
   • 匹配目标快捷键后返回0阻止系统处理，同时调用自定义逻辑。注意保存原始窗口过程，其他消息需转发给原始过程保障GLFW正常功能。

macOS平台 #

1. 获取GLFW窗口的NSWindow指针：

   NSWindow* nsWindow = glfwGetCocoaWindow(window);
   

2. 添加事件监视器：
   通过Cocoa的NSEvent注册全局事件监视器，拦截keyDown事件：
   • 识别Command+Space：判断keyCode == 49且[event modifierFlags] & NSCommandKeyMask
   • 匹配后调用[event suppressCurrentEvent]阻止系统响应，同时触发自定义按键逻辑。仅在GLFW窗口激活时启用拦截，避免影响其他应用。

Linux平台（X11） #

1. 获取GLFW窗口的X11句柄与显示对象：

   Window x11Window = glfwGetX11Window(window);
   Display* display = glfwGetX11Display();
   

2. 注册X11事件过滤器：
   使用XSelectInput监听KeyPress事件，识别目标快捷键（如Alt+Tab）：
   • 匹配后调用XSendEvent标记事件已处理，阻止系统传递。可通过XGrabKeyboard在窗口激活时保持键盘焦点，避免强制抢占焦点引发异常。

通用GLFW配合逻辑 #

• 在GLFW窗口焦点回调中记录窗口激活状态：仅当窗口激活时启用平台拦截逻辑，窗口因光标移出点击外部失焦时关闭拦截，恢复系统正常快捷键功能。
• 自定义按键处理逻辑统一放在GLFW按键回调中，平台拦截代码仅负责阻止系统行为并触发GLFW回调。

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