xkb 第6章 server 中的键事件处理

本章节介绍在存在 XKB 扩展的 server 中处理键事件所涉及的步骤。键盘活动可以生成键事件，并通过 DDX 层传递给 XKB，或者可以通过其他扩展（例如 XTEST）合成。

应用全局 controls

当 XKB 收到键事件时，它首先检查全局 controls 以决定是否立即处理或者不处理事件。按照优先级由高到低可能影响事件的全局 controls 有：

• 如果在启用 BounceKeys control 时按下某个键，则仅当该键处于活动状态时，XKB 才会生成该事件。当释放按键时，server 将取消激活该键，并且以 debounce delay 指定的时间间隔启动一个 bounce keys 计时器。

  如果 bounce keys 计时器到期或者在计时器到期之前按下某个其他键，则 server 重新激活相应的键（之前取消激活的键）并停用计时器。bounce keys timer 的到期或停用都不会导致事件。

• 如果启用了 SlowKeys control，则不立即处理键事件，而是以 slow keys delay 指定的时间间隔设置 slow keys 计时器。相应的键释放将停用此计时器。

  如果 slow keys 计时器到期，则 server 生成对应的键事件，发送 XkbAccessXNotify并停用计时器。

• XKB 正常处理键事件，不管 RepeatKeys control 是否启用，但如果启用了 RepeatKeys 并且该事件中的键启用了 per-key autorepeat，则 XKB 正常处理键事件，但它也以 autorepeat delay 指定的时间段初始化 autorepeat 计时器，相应的键释放将停用计时器。

  如果 autorepeat 计时器到期，则 server 为相应的键生成 release 和 press 事件，并且根据 autorepeat interval 重新安排计时器。

键事件由每个全局 control 依次处理：如果 BounceKeys control 接受键事件，则 SlowKeys control 会考虑它。一旦 SlowKeys control 允许或合成事件，RepeatKeys control 就会对其进行操作。

键 Behavior

一旦事件被所有 controls 接受或由计时器生成，server 就会检查相应键的 pre-key behavior。此扩展目前定义了如下键 behaviors：

• KB_Default —— press 和 release 事件被正常处理

• KB_Lock —— 如果键是逻辑上的 up（即core key map 相应 bit 被清除），当它被按下再释放，press 被正常处理，但忽略相应的 release。如果键是逻辑上的 down，当它被按下再释放，press 被忽略但相应的 release 被正常处理。

• KB_RadioGroup（flags: CARD8，index: CARD8） —— 如果 index 指定的 radio group 的另一个成员是逻辑上的 down，当键被按下，server 为那个逻辑上 down 的成员合成 key release 事件，然后正常处理键的 press 事件。

  如果键它自己是逻辑上的 down，当键被按下，press 事件被忽略，但根据 flags 中 RGAllowNone bit 的值处理相应键的释放 。 如果它设置了，则 release 被正常处理；否则 release 被忽略。

  所有其他键 release 事件被忽略。

• KB_Overlay1（key: KEYCODE） —— 如果 Overlay1 control 被启用，报告来自此键的事件，就好像它们来自 key 参数指定的键一样，否则，正常处理 press 和 release 事件。

• KB_Overlay2（key: KEYCODE） —— 如果 Overlay2 control 被启用，报告来自此键的事件，就好像它们来自 key 参数指定的键一样，否则，正常处理 press 和 release 事件。

X server 使用键 behavior 来确定是处理还是过滤掉任何给定的键事件；键 behavior 是独立于键盘 modifier 和 group state 的（每个键只能有一个behavior）。

键 behavior 可以用于模拟任何这些类型的键或去指示键的不可修改的物理、电器或软件驱动特征。一个可选的 permanent flag 可以修改任何支持的 behaviors 并指示此 behavior 描述了键盘的不可更改的物理、电器或软件方面。permanent behaviors 不能被 XkbSetMap 请求修改和设置。permanent flag 表示 XKB 不能影响的底层系统的特征，因此 XKB 将所有 permanent behaviors 视为 KB_Default 并且不过滤上表中描述的键事件。

我经过测试后，发现无法通过 GetMap 请求获取键 behaviors 了，回复中 totalKeyBehaviors 始终为 0。

键 Actions

一旦 server 应用了全局 controls 和 pre-key behaviors 并决定去处理键事件，它应用键 action 来确定该键对 server 内部 state 的影响。键 action 由操作符和一些可选数据组成。XKB 支持以下 actions：

• 修改 modifier 或 group 的 基本、暂锁、锁定 state
• 移动核心指针或模拟核心指针按钮事件
• 改变键盘 behavior 的大多数方面
• 终止或挂起（suspend）server
• 给感兴趣的 clients 发送消息
• 模拟其他键的事件

每个键都有一个可选的 actions 列表。如果存在，则该列表与键相关的符号平行（即与键相关的每个符号有一个 action）。对于键 press 事件，server 使用和事件中的键相关的 key symbol mapping 从列表查找要被应用的 action，就像 client 查找符号一样；如果事件中的键没有任何 actions，则 server 使用 SA_NoAction, 而不管 modifier 或 group 的 state 如何。

键 action 实际上分为两半；当键被按下对 server 的效果和当键被释放的效果。被应用于键 press 事件的 action 决定进一步的actions，如果有，这些 action 被应用于相应键的 release 事件或当键持续按下时的事件。当键是 down 时 client 可以改变与键相关的 actions，且不修改下次键释放被应用的 action；后续的 press-release pairs 将会使用新绑定的键action。

大多数对键盘 modifier state 有影响的 actions 的参数有名为 mods 的 modifier 定义和名为 useModMap 的 boolean flag。这两个字段组合在一起指定受 action 影响的 modifiers： 如果 useModMap 是 True，则 action 设置通过 modifier mapping 绑定到初始化该 action 的键的任何 modifiers；否则， action 设置由参数 mods 指定的 modifiers。为简洁起见，我们将 userModMap 和 mods 的这种组合称为“action modifiers”。

XKB 支持如下 actions：

• SA_NoAction —— 无直接影响，尽管 SA_NoAction 可能会改变其他 server actions 的影响（见下文）。

• SA_SetMods（mods: MOD_DEF，useModMap: BOOL，clearLocks: BOOL） ——

  • 键 press 增加任何 action modifiers 到键盘的基本 modifiers。
  • 键 release 清除在键盘基本 modifiers 中的任何 action modifiers。
  • 如果没有和此键同时操作其他键，并且设置了 clearLocks ，release 解锁任何 action modifiers。

• SA_LatchMods（mods: MOD_DEF，useModMap: BOOL，clearLocks: BOOL，latchToLock: BOOL） ——

  • 键 press 和 release 事件与 SA_SetMods 具有相同效果；如果没有和正在暂锁 modifier 的键同时操作其他键，键 release 事件有如下附加效果：
  • 由 clearLocks 而被解锁的 modifiers 没有进一步效果。
  • 如果设置了 latchToLock，则键 release 会锁定然后解除暂锁已经被暂锁的任何剩余的 action modifiers。
  • 最后，键 release 会暂锁任何未被 clearLocks 或 latchToLock flags 使用过的 action modifiers。

• SA_LockMods (mods: MOD_DEF, useModMap: BOOL, noLock: BOOL, noUnlock: BOOL) ——

  • 键 press 设置任何 action modifiers 的基本和可能的锁定 state。如果 noLock 是 True，则仅基本 state 被改变。
  • 对于键 release 事件，清除键盘基本 modifiers 中的任何 action modifiers，前提是没有其他影响相同 modifiers 的键是 down。如果 noUnlock 是 False 且在相应键按下之前任何 action modifiers 被锁定，键 release 解锁它们。

• SA_SetGroup（group: INT8，groupAbsolute: BOOL，clearLocks: BOOL） ——

  • 如果设置了 groupAbsolute，则键 press 事件改变键盘基本 group 为参数 group；否则，把参数 group 增加到键盘基本 group。则任何一种情况下，生成的键盘有效 group 根据键盘的 GroupsWrap control 的值被带到范围内。
  • 如果在按住此键的同时按下有SA_ISOLock action 的键，键 release 无效果，否则它取消 press 的效果。
  • 如果没有和此键同时操作其他键，并且设置了 clearLocks ，键 release 也设置键盘锁定 group 为 Group1。

• SA_LatchGroup（group: INT8，groupAbsolute: BOOL，clearLocks: BOOL，latchToLock: BOOL）——

  • 键 press 和 release 事件和 SA_SetGroup action 有相同效果；如果没有和正在暂锁 group 的键同时操作其他键并且 clearLocks flag 没有设置或没有效果，键 release 有如下效果：
  • 如果设置了 latchToLock 且键盘暂锁 group 不是 0，键 release 增加应用到相应键 press 的 delta 到键盘锁定 group，并从键盘暂锁 group 减去它。键盘锁定和有效 group 根据键盘的 GroupsWrap control 的值被带到范围内。
  • 否则，键 release 增加键 press delta 到键盘暂锁 group。

  注：这里的 delta 不太明确。

• SA_LockGroup（group: INT8，groupAbsolute: BOOL） ——

  • 如果设置了 groupAbsolute，键 press 设置键盘锁定 group 为参数 group。否则，键 press 把参数 group 增加到键盘锁定 group。在任何一种情况下，生成的键盘锁定和有效 group 根据键盘的 GroupsWrap control 的值被带到范围内。
  • 键 release 没有效果。

• SA_MovePtr（x, y: INT16，noAccel: BOOL，absoluteX: BOOL，absoluteY: BOOL）——

  • 如果未启用 MouseKeys control，则此 action 行为类似于 SA_NoAction，否则此 action 取消任何此键即将触发的 repeat key timers，并具有以下附加效果。
  • 键 press 生成核心指针 MotionNotify 事件而不是通常的 KeyPress 事件。如果 absoluteX 为 True，参数 x 指定新的指针 X 座标，否则参数 x 被增加到指针当前的X 座标； absoluteY 和参数 y 以相同的方式指定新的 Y 坐标。
  • 如果 noAccel 为 False，并且启用了 MouseKeysAccel control，键 press 也为此键初始化 mouse keys 计时器；每次该计时器到期时，光标再次移动。光标在这些后续事件中移动的距离由鼠标键加速决定，如 MouseKeysAccel Control 中所述。
  • 键 release 除了停用 mosue keys 计时器（如果它被相应键 press 初始化了），就没有其他效果并被忽略（不会生成任何类型的事件）。

• SA_PtrBtn（button: CARD8，count: CARD8，useDfltBtn: BOOL） ——

  • 如果未启用 MouseKeys control，则此 action 的行为类似于 SA_NoAction。
  • 如果设置了useDfltBtn，则会为当前的默认核心按钮生成事件。否则，将为参数 button 指定的按钮生成事件。
  • 如果此 action 的参数 button 指定的按钮是逻辑上 down，则键 press 和相应的 release 被忽略且无效。
  • 否则，键 press 导致一个或多个核心指针按钮事件，而非通常的键 press 事件。如果 count 为 0，则键 press 会生成一个 ButtonPress 事件； 如果 count 大于 0，则键 press 会生成 count 对的 ButtonPress 和 ButtonRelease 事件。
  • 如果 count 为 0，则键 relase 生成一个核心指针 ButtonRelease 事件，它与相应的键 press 生成的事件相匹配；如果 count 大于 0，则键 release 不会导致 ButtonRelease 事件。键 release 永远不会导致键 release 事件。

• SA_LockPtrBtn（button: BUTTON，noLock: BOOL，noUnlock: BOOL，useDfltBtn: BOOL） ——

  • 如果未启用 MouseKeys control，则此 action 的行为类似于 SA_NoAction。
  • 否则，如果由参数 useDfltBtn 和 button 指定的按钮未被锁定，键 press 导致一个 ButtonPress 事件而非键 press 事件且锁定此按钮。如果此按钮已经被锁定或如果 noLock 是 True，键 press 被忽略且无效。
  • 如果相应的键 press 被忽略，并且 noUnlock 为 False， 键 release 生成一个 ButtonRelease 事件而非键 release 事件且解锁指定的按钮。如果相应的键 press 锁定一个按钮，键 release 被忽略且无效。

• SA_SetPtrDflt（affect: CARD8，value: CARD8，dfltBtnAbs: BOOL）——

  • 如果未启用 MouseKeys control，则此 action 的行为类似于 SA_NoAction。
  • 否则，键 press 和 release 都被忽略，除了键 press 修改指针由参数 affect 指定的指针值为参数 value，如下所示：
  • 如果 affect 设置了 SA_AffectDfltBtn，参数 value 和 dfltBtnAbs 指定了被用于各种指针 action 的默认指针按钮，如下所示： 如果 dfltBtnAbs 是 True，参数 value 指定要被使用的按钮，否则，参数 value 指定要被增加到当前默认按钮的数量。 在任何一种情况下，非法的按钮选择都会被 wrap 回到范围内。

• SA_ISOLock（dfltIsGroup: False，mods: MOD_DEF，useModMap: BOOL，noLock: BOOL，noUnlock: BOOL，noAffectMods: BOOL，noAffectGrp: BOOL，noAffectPtr: BOOL，noAffectCtrls: BOOL） 或 （dfltIsGroup: True，group: INT8，groupAbsolute: BOOL，noAffectMods: BOOL，noAffectGrp: BOOL，noAffectPtr: BOOL，noAffectCtrls: BOOL）——

  • 如果 dfltIsGroup 为 True，则键 press 设置由参数 groupAbsolute 和 group 指定的基本 group， 否则，键 press 设置 action modifier 到键盘的基本 modifiers。
  • 键 release 清除由键 press 设置的基本 modifiers 或 group；如果没有其他适当的 action 与 SA_ISOLock action 同时发生，它可能会产生额外的影响。
  • 如果noAffectMods 为 False，则与此 action 同时发生的 SA_SetMods 或 SA_LatchMods action 将被视为 SA_LockMods action。
  • 如果 noAffectGrp 为 False，则与此 action 同时发生的 SA_SetGroup 或 SA_LatchGroup action 将被视为SA_LockGroup action。
  • 如果 noAffectPtr 为 False，则与此 action 同时发生的 SA_PtrBtn action 被视为 SA_LockPtrBtn action。
  • 如果 noAffectCtrls 为 False，则与此 action 同时发生的 SA_SetControls action 将被视为 SA_LockControls action。
  • 如果 SA_ISOLock action 未转换其他 action，则键 release 将锁定由 action 参数指定的 group 或 modifiers。

• SA_TerminateServer ——

  • 键 press 终止 server， 键 release 被忽略。
  • 此 action 是可选的；servers 可以自由忽略它，如果被忽略，它的行为类似于 SA_NoAction。

• SA_SwitchScreen（num: INT8，switchApp: BOOL，screenAbs: BOOL） ——

  • 如果 server 支持此 action 和多个 screens 或 displays （虚拟或真实），则此 action 将 num 和 screnAbs 指定的 screen 改为活动 screen。 如果 screenAbs 为 True， num 指定新 screen 的索引；否则，num 指定从当前活动 screen 到新 screen 的偏移量。
  • 如果 switchApp 是 False，则应切换到同一个 server 的另一个 screen 上。否则，应切换到另一个共享相同物理 display 的 X server 或应用程序。
  • 此 action 是可选的； server 如果不支持请求的行为可以自由忽略它或它的任何 flags。如果 action 被忽略，它的行为类似于 SA_NoAction，否则键 press 或 release 都不会生成事件。

• SA_SetControls（controls: KB_BOOLCTRLMASK) ——

  • 键 press 启用 control 中指定的任何在键按下时尚未启用的 boolean controls，键 release 禁用相应键 press 启用的任何 controls。 此 action 可导致 XkbControlsNotify 事件。

• SA_LockControls（controls: KB_BOOLCTRLMASK，noLock: BOOL，noUnlock: BOOL ）——

  • 如果 noLock 为 False，则键 press 锁定和启用参数 controls 中指定的且在键按下时尚未被锁定的任何 controls。如果 noUnlock 为 False，键 release 解锁和禁用任何在参数 controls 中指定且相应键按下时尚未被启用的任何 controls。

• SA_ActionMessage（pressMsg: BOOL，releaseMsg: BOOL，genEvent: BOOL，message: STRING）——

  • 如果 pressMsg 为 True，则键 press 生成 XkbActionMessage 事件，该事件报告 keycode，event type 和 message 的内容。
  • 如果 releaseMsg 为 True， 则键 release 生成 XkbActionMessage 事件，该事件报告 keycode，event type 和 message 的内容。
  • 如果 genEvent为True，则键 press 和 release 都会生成 key press 和 key release 事件，无论它们是否也导致XkbActionMessage 事件。

• SA_RedirectKey（newKey: KEYCODE，modsMask: KEYMASK，mods: KEYMASK，vmodsMask: CARD16，vmods: CARD16） ——

  • 键 press 导致参数 newKey 指定的键的 key press 事件，而非实际的键。事件中报告的 state 字段的当前有效 modifier 修改如下：任何在 modsMask 中指定的真实 modifiers 都被设置为 mods 中的相应值。任何被绑定到 vmodsMask 中指定的虚拟 modifiers 的真实 modifier 都被设置或清除， 具体取决于 vmods 中的相应值。如果真实和虚拟 modifier 定义给单个 modifier 指定了冲突的值，真实 modifier 定义优先。
  • 键 release 导致参数 newKey 指定的键的 key release 事件；对事件的 state 字段中的键盘的有效 modifiers 进行更改如上所述。
  • 此 action 通常会重定向到同一设备的另一个的键，好像此键或按钮导致了此事件，除非该设备不属于 input 扩展 KEYCLASS，这种情况下，此 action 会导致核心键盘设备上的事件。

• SA_DeviceBtn（count: CARD8，button: BUTTON，device: CARD8） ——

  • device 字段指定扩展设备的 ID；button 字段指定该设备上的按钮的索引。如果此 action 指定的按钮是逻辑上 down，则键 press 和相应的 release 被忽略且无效。如果此 action 指定的设备或按钮无效，则此 action 的行为类似于 SA_NoAction。
  • 否则，键 press 会导致一个或多个 input 扩展设备按钮事件，而非通常的 key press 事件。如果 count 为 0，键 press 生成单个 DeviceButtonPress 事件；如果 count 大于 0，键 press 生成 count 对 DeviceButtonPress 和 DeviceButtonRelease 事件。
  • 如果 count 为 0，键 release 生成一个 input 扩展 DeviceButtonRelease 事件，它匹配相应键 press 生成的事件；如果 count 大于 0，键 release 不导致 DeviceButtonRelease 事件。键 release 永远不会导致 key release 事件。

• SA_LockDeviceBtn（button: BUTTON，device: CARD8，noLock: BOOL，noUnlock: BOOL ——

  • device 字段指定扩展设备的 ID；button 字段指定该设备上的按钮的索引。如果此 action 指定的按钮是逻辑上 down，则键 press 和相应的 release 被忽略且无效。如果此 action 指定的设备或按钮无效，则此 action 的行为类似于 SA_NoAction。
  • 否则，如果指定的按钮未锁定且　noLock　为　False，则键 press 会导致 input 扩展 DeviceButtonPress 事件而不是 key press 事件，并锁定按钮。如果该按钮已被锁定或者如果 noLock 为 True，则键 press 被忽略并且无效。
  • 如果相应的键 press 被忽略了，并且 noUnlock 为 False，键 release 会生成 input 扩展 DeviceButtonRelease 事件，而不是核心协议或 input 扩展的键 release 事件，并解锁指定的按钮。如果相应的键 press 锁定按钮，则键 release 被忽略并且无效。

• SA_DeviceValuator （device : CARD8，val1What : SA_DVOP，val1 : CARD8，val1Value : INT8，val1Scale : 0...7，val2What : SA_DVOP，val2 : CARD8，val2Value : INT8，val2Scale : 0...7）——

  • device 字段指定扩展设备的 ID; val1 和 val2 指定该设备上的 valuators。如果 device 是无效的，或者 val1 和 val2 都没有指定有效的 valuator，则此 action 的行为类似于 SA_NoAction。
  • 如果 valn 指定了有效的 valuator，并且 valnWhat 不是 SA_IgnoreVal，则按照 valnWhat 指定的方式调整指定的值：
  • 如果 valnWhat 是 SA_SetValMin，则 valn 被设置为它的最小有效值。
  • 如果 valnWhat 是 SA_SetValCenter，则 valn 被居中（为 (max-min)/2）。
  • 如果 valnWhat 是 SA_SetValMax，则 valn 被设置为它的最大有效值。
  • 如果 valnWhat 是 SA_SetValRelative，则 被增加到 valn。
  • 如果 valnWhat 是 SA_SetValAbsolute，则 valn 被设置为 。
  • SA_SetValRelative 或 SA_SetValAbsolute 导致的无效值被限制在范围内。

如果启用了 StickyKeys，则所有 SA_SetMods 和 SA_SetGroup actions 分别像 SA_LatchMods 和 SA_LatchGroup。如果设置了 LatchToLock AccessX option，则任一 action 都表现为设置了 SA_ClearLocks 和 SA_LatchToLock flags。

导致事件来自另一个键或来自另一个设备的按钮的 actions 立即生成指定的事件。这些 actions 不考虑绑定到事件重定向到的键或按钮的 behavior 或 actions（如果有）。

server actions 生成的核心事件包含在键事件发生时生效的键盘 state;报告的 state 不会反映由于导致它们的、绑定到键事件的 actions 而导致的 state 中的任何改变。

发送到未发出 XkbUseExtension 请求的 clients 的事件包含兼容 state，而不是实际的 XKB 键盘 state。有关此兼容性映射的说明，请参阅 XKB 对核心协议事件的影响。

传递键或按钮事件到 client

接收核心协议和 input 扩展的键或按钮事件的窗口和 client 使用由核心协议和 input 扩展指定的焦点策略、窗口层次结构和被动 grabs 来确定，并进行以下更改：

• 如果 grab 中指定的 modifier state 与兼容性 grab state （在键盘 state 的兼容性组件中描述）匹配，则会触发被动 grab。 通过设置 GrabsUseXKBState per-client flag，clients 可以选择使用 XKB grab state。此 flag 影响所有由设置了它的 client 请求的所有被动 grabs，但不会影响其他 client 设置的被动 grabs。
• 导致了被动 grab 的事件的 state 字段报告在 grab 被触发时有效的 XKB 或兼容性 grab state；当键或按钮被释放，相应 release 事件的 state 字段报告相应的有效的 grab state。
• 如果设置了 LookupStateWhenGrabbed per-client flag，则在键盘或指针 grab 激活时发生的所有键或按钮事件包含 XKB 或兼容性 lookup state，具体取决于 GrabsUseXKBState per-client flag 的值。如果未设置 LookupStateWhenGrabbed，则它们包括 XKB 或兼容性 grab state。
• 另外，不触发被动 grab 报告的事件的 state 字段是从 XKB 有效 modifiers 和 group 派生的，如从 XKB State 计算 State 字段中所述。
• 如果键 release 事件是自动重复键正在被按下的结果，且要接收事件的 client 请求了可检测的自动重复，则事件不会传递到此 client。

以下部分说明了 XKB 与核心协议 grabs 的交互的意图和需要 pre-client flags 的原因。

XKB 与核心协议 grabs 的交互

XKB 提供单独的 lookup 和 grab state，以帮助解决核心协议指定被动 grabs 方式的一些困难。不幸的是，许多 client 以不同的方式解决这些问题，而XKB处理 grabs 和报告键盘 state 的方式有时会以意外和不愉快的方式与这些 client 的变通方法进行交互。

为了给知道 XKB 的 clients 提供更合理的行为，而不会导致不知道 XKB 的 clients 出现问题，XKB 提供两个 per-client flags （GrabsUseXKBState 和 LookupStateWhenGrabbed），用于指定 XKB 与核心协议应该如何交互。

• 最大的问题来自于 XKB State 字段在 bits 13-14 编码显式的键盘 group，而 pre-XKB clients 使用 8 个 modifiers 来选择哪个键盘 group。为了使现有 client 行为合理，XKB 通常使用兼容性 grab state 而非 XKB grab state 来确定是否触发被动 grabs。XKB-aware clients 可以设置 GrabsUseXKBState per-client flag，以指示它们使用 XKB state 指定被动 grabs。

• 当触发被动 grab 时，一些 toolkits 会开始主动 grab，以便更好地控制 grab 终止的条件。不幸的是，XKB 在 触发或终止 grabs 事件报告不同 state 意味着此 grab 模拟在某些情况下无法终止 grab。要解决此问题，XKB 在 grab 激活时在所有事件中报告 grab state。不使用此类主动 grabs 的 clients 可以设置 LookupStateWhenGrabbed per-client flag，以便无论 grab 是否激活，收到相同的 state 组件。

  GrabsUseXKBState per-client flag 也适用于在 grab 激活时发送的事件的 state。如果设置了，grab 期间的事件包含 XKB lookup 或 grab state；默认情况下，grab 期间的事件包含兼容性 lookup 或 grab state。

用于触发被动 grab 的 state 由 grab 注册时的 GrabsUseXKBState per-client flag 设置控制。修改此 flag 不会影响现有的被动 grabs。