X11/Xlib 的全局热键

Question

我的目标是拥有一个在后台休眠但可以由用户通过某些“热键”激活的程序。通过深入研究 Xlib 手册和 Xlib O'reilly 手册，我发现正确的方法是使用 XGrabKey。然而，我对这个过程的理解是不正确的，因为简单的概念证明不起作用。

我的理解是，如果我使用根窗口作为grab_window调用XGrabKey，并且owner_events为假，那么每当按下我的热键时，事件将仅发送到根窗口。如果我然后从根窗口中选择 KeyPress 事件，然后监听 X 事件，那么当按下热键时，我应该得到一个按键事件。我在下面粘贴了一个最小的例子。

我期望的是，当程序运行时，无论哪个窗口具有焦点，如果按下 Ctrl+Shift+K，我的程序应该输出“按下热键！”在控制台中，然后终止。

此外，据我了解，如果 XGrabKey 失败，默认错误处理程序将显示一条消息，并且由于它不会显示，因此我假设调用成功。

显然，我的理解在某种程度上是有缺陷的。有人能指出我正确的方向吗？

#include <iostream>
#include <X11/Xlib.h>
#include <X11/Xutil.h>


using namespace std;


int main()
{
    Display*    dpy     = XOpenDisplay(0);
    Window      root    = DefaultRootWindow(dpy);
    XEvent      ev;

    unsigned int    modifiers       = ControlMask | ShiftMask;
    int             keycode         = XKeysymToKeycode(dpy,XK_Y);
    Window          grab_window     =  root;
    Bool            owner_events    = False;
    int             pointer_mode    = GrabModeAsync;
    int             keyboard_mode   = GrabModeAsync;

    XGrabKey(dpy, keycode, modifiers, grab_window, owner_events, pointer_mode,
             keyboard_mode);

    XSelectInput(dpy, root, KeyPressMask );
    while(true)
    {
        bool shouldQuit = false;
        XNextEvent(dpy, &ev);
        switch(ev.type)
        {
            case KeyPress:
                cout << "Hot key pressed!" << endl;
                XUngrabKey(dpy,keycode,modifiers,grab_window);
                shouldQuit = true;

            default:
                break;
        }

        if(shouldQuit)
            break;
    }

    XCloseDisplay(dpy);
    return 0;
}

Answer 1

使用您的面罩 ControlMask | ShiftMask 如果按住另一个修饰键，您将无法获得该键。这听起来不错，但有一个陷阱：NumLock、CapsLock 等都被视为修饰符。

您有两种选择：

• 多次调用 XGrabKey()，针对您感兴趣的每个显式组合调用一次。
• 您使用 AnyModifier< 调用 XGrabKey() /code> 并使用 event.xkey.state 检查修饰符是否符合您的预期。

头文件定义了ShiftMask、LockMask、ControlMask、Mod1Mask 、Mod2Mask、Mod3Mask、Mod4Mask、Mod5Mask 和 AnyModifier。

这些键是：

Mask        | Value | Key
------------+-------+------------
ShiftMask   |     1 | Shift
LockMask    |     2 | Caps Lock
ControlMask |     4 | Ctrl
Mod1Mask    |     8 | Alt
Mod2Mask    |    16 | Num Lock
Mod3Mask    |    32 | Scroll Lock
Mod4Mask    |    64 | Windows
Mod5Mask    |   128 | ???

警告 我通过尝试发现了 ModNMask 键，但我不知道这是否在所有机器/配置/版本/操作系统上都有效。

就您而言，您可能需要确保 ShiftMask | CtrlMask 已设置，Mod1Mask | Mod4Mask 很清楚，其他的可以忽略。

我这样做是为了设置按键抓取：

XGrabKey(dpy, keycode, AnyModifier, grab_window, owner_events, pointer_mode, keyboard_mode);

这是为了检查是否设置了正确的修饰符：

switch (ev.type)  {
case KeyPress:
    if ((ev.xkey.state & (ShiftMask | CtrlMask | Mod1Mask | Mod4Mask)) == (ShiftMask | CtrlMask))
        // ...
}

Answer 2

如果您在 X11 上使用/定位 gtk，则有一个具有更简单界面的 C 库：

https://github .com/engla/keybinder

包括 Python、Lua 和 Vala 绑定。 （此处也提到了。）

Answer 3

你的程序在这里运行。我的猜测是您有另一个处于活动状态的修饰符，例如 NumLock。 GrabKey 仅适用于 exact 修饰符掩码。

例如，这是来自metacity窗口管理器的一些（GPL）代码

/* Grab/ungrab, ignoring all annoying modifiers like NumLock etc. */
static void
meta_change_keygrab (MetaDisplay *display,
                     Window       xwindow,
                     gboolean     grab,
                     int          keysym,
                     unsigned int keycode,
                     int          modmask)
{
  unsigned int ignored_mask;

  /* Grab keycode/modmask, together with
   * all combinations of ignored modifiers.
   * X provides no better way to do this.
   */

  meta_topic (META_DEBUG_KEYBINDINGS,
              "%s keybinding %s keycode %d mask 0x%x on 0x%lx\n",
              grab ? "Grabbing" : "Ungrabbing",
              keysym_name (keysym), keycode,
              modmask, xwindow);

  /* efficiency, avoid so many XSync() */
  meta_error_trap_push (display);

  ignored_mask = 0;
  while (ignored_mask <= display->ignored_modifier_mask)
    {
      if (ignored_mask & ~(display->ignored_modifier_mask))
        {
          /* Not a combination of ignored modifiers
           * (it contains some non-ignored modifiers)
           */
          ++ignored_mask;
          continue;
        }

      if (meta_is_debugging ())
        meta_error_trap_push_with_return (display);
      if (grab)
        XGrabKey (display->xdisplay, keycode,
                  modmask | ignored_mask,
                  xwindow,
                  True,
                  GrabModeAsync, GrabModeSync);
      else
        XUngrabKey (display->xdisplay, keycode,
                    modmask | ignored_mask,
                    xwindow);

      if (meta_is_debugging ())
        {
          int result;

          result = meta_error_trap_pop_with_return (display, FALSE);

          if (grab && result != Success)
            {      
              if (result == BadAccess)
                meta_warning (_("Some other program is already using the key %s with modifiers %x as a binding\n"), keysym_name (keysym), modmask | ignored_mask);
              else
                meta_topic (META_DEBUG_KEYBINDINGS,
                            "Failed to grab key %s with modifiers %x\n",
                            keysym_name (keysym), modmask | ignored_mask);
            }
        }

      ++ignored_mask;
    }

  meta_error_trap_pop (display, FALSE);
}