XQueryPointer 掩码返回值中的位代表什么键？答案

【问题标题】：What keys do the bits in the XQueryPointer's mask_return values represent?XQueryPointer 掩码返回值中的位代表什么键？
【发布时间】：2018-07-22 21:17:32
【问题描述】：

在 X11 编程中，我们有时会使用 XQueryPointer 函数来确定鼠标在屏幕上的位置。

在 xlib.h 中，我们还可以看到该函数填充了一个名为 mask_return 的整数，其中包含代表按键的各个标志：

extern Bool XQueryPointer(
    Display*,
    Window,
    Window*,
    Window*,
    int*,
    int*,
    int*,
    int*,
    unsigned int*  /* mask_return */
);

我使用以下代码对此进行了实验：

Display *display = XOpenDisplay(nullptr);
int screen = DefaultScreen(display);
Window rootWin = RootWindow(display, screen);
Window qRoot;
Window qChild;
int qRootX;
int qRootY;
int qChildX;
int qChildY;
unsigned int qMask;
while(true)
{
  if(XQueryPointer(display, rootWin, &qRoot, &qChild, &qRootX, &qRootY, &qChildX, &qChildY, &qMask))
  {
    for(int i = 0; i < sizeof(int) * 8; i++)
    {
      int mask = 1 << sizeof(int) * 8 - i - 1;
      if(mask & qMask)
      {
        printf("1");
      }
      else
      {
        printf("0");
      }
    }
    printf("(%d)\n", qMask);
  }
}

使用这种方法，我已经能够隔离以下标志：

00000000000000000000000000000001(1)：如果在调用 XQueryPointer 时按下左移键或右移键，则此标志处于打开状态。
00000000000000000000000000001000(4)：如果在调用 XQueryPointer 时按下左或右控制键，则此标志打开。
00000000000000000000000000010000(8)：如果在调用 XQueryPointer 时按下左或右 alt 键，则此标志打开。
00000000000000000000001000000000(256)：如果在调用 XQueryPointer 时按下 mouse1，则此标志处于打开状态。
00000000000000000000010000000000(512)：如果在调用 XQueryPointer 时按下 mouse3，则此标志处于打开状态。
00000000000000000000100000000000(1024)：如果在调用 XQueryPointer 时按下 mouse2，则此标志处于打开状态。

您会认为对于一个 30 多年历史的 API，这些标志的文档将被广泛使用，但我似乎在任何地方都找不到提及它们。

有人知道剩余的标志是否/用于什么用途，或者我可以在哪里了解更多关于它们的信息？

此外，我可以相信相同的标志在不同的系统上总是意味着相同的东西吗？

【问题讨论】：

这可能会有所帮助：tronche.com/gui/x/xlib/events/keyboard-pointer/…
“相同的标志在不同的系统上意味着相同的事情”到底是什么意思？ ShiftMask 将始终对应 shift 修饰符，但触发修饰符的键是键盘布局的属性，实际上可以不同。
@UliSchlachter 我一直在寻找不同发行版可能在掩码内的不同位置为同一事件引发标志的情况。例如，CentOS 可能会为 mouse1 事件翻转第 16 位而不是第 8 位。因为，正如您的回答所表明的那样，掩码是在 X 本身中定义的，这似乎不太可能。

标签： c++ x11 xlib

【解决方案1】：

直接来自X.h：

/* Key masks. Used as modifiers to GrabButton and GrabKey, results of QueryPointer,
   state in various key-, mouse-, and button-related events. */

#define ShiftMask       (1<<0)
#define LockMask        (1<<1)
#define ControlMask     (1<<2)
#define Mod1Mask        (1<<3)
#define Mod2Mask        (1<<4)
#define Mod3Mask        (1<<5)
#define Mod4Mask        (1<<6)
#define Mod5Mask        (1<<7)

稍后在同一个文件中：

/* button masks.  Used in same manner as Key masks above. Not to be confused
   with button names below. */

#define Button1Mask     (1<<8)
#define Button2Mask     (1<<9)
#define Button3Mask     (1<<10)
#define Button4Mask     (1<<11)
#define Button5Mask     (1<<12)

【讨论】：

啊，谢谢！我遵循 XQueryPointer 定义到 xlib.h，其中唯一的描述是“掩码返回”。