1XkbSARedirectSetVModsMask(3) XKB FUNCTIONS XkbSARedirectSetVModsMask(3)
2
6 XkbSARedirectSetVModsMask - Sets the vmods_mask0 and vmods_mask1 fields
7 of act from vm
8
10 void XkbSARedirectSetVModsMask (XkbRedirectKeyAction act, unsigned int
11 vm);
12
14 - act action in which to set vmods
15 - vm new value for virtual modifier mask
17
19 Actions associated with the XkbRedirectKeyAction structure generate
20 KeyPress and KeyRelease events containing a keycode different from the
21 key that was pressed or released.
22 The type field for the XkbRedirectKeyAction structure should always be
24 XkbSA_RedirectKey. Key presses cause a KeyPress event for the key
25 specified by the new_key field instead of the actual key. The state
26 reported in this event reports the current effective modifiers changed
27 as follows: any real modifiers selected by the mods_mask field are set
28 to corresponding values from the mods field. Any real modifiers bound
29 to the virtual modifiers specified by the vmods_mask0 and vmods_mask1
30 fields are either set or cleared, depending on the corresponding values
31 in the vmods0 and vmods1 fields. If the real and virtual modifier defi‐
32 nitions specify conflicting values for a single modifier, the real mod‐
33 ifier definition has priority.
34 Key releases cause a KeyRelease event for the key specified by the
36 new_key field instead of the actual key. The state for this event con‐
37 sists of the effective keyboard modifiers at the time of the release,
38 changed as described previously.
39 The XkbSA_RedirectKey action normally redirects to another key on the
41 same device as the key that caused the event, unless that device does
42 not belong to the input extension KeyClass, in which case this action
43 causes an event on the core keyboard device. (The input extension cate‐
44 gorizes devices by breaking them into classes. Keyboards, and other
45 input devices with keys, are classified as KeyClass devices by the
46 input extension.)
47 The vmods_mask0 and vmods_mask1 fields actually represent one
49 vmods_mask value. Xkb provides macros to convert between the two for‐
50 mats.
51 XkbSARedirectSetVModsMask sets the vmods_mask0 and vmods_mask1 fields
53 of act from vm.
54
56 typedef struct_XkbRedirectKeyAction {
57 unsigned char type; /∗ XkbSA_RedirectKey */
58 unsigned char new_key; /∗ keycode to be put in event */
59 unsigned char mods_mask; /∗ mask of real mods to be reset */
60 unsigned char mods; /∗ mask of real mods to take values from */
61 unsigned char vmods_mask0; /∗ first half of mask of virtual mods to be
62 reset */
63 unsigned char vmods_mask1; /∗ other half of mask of virtual mods to be
64 reset */
65 unsigned char vmods0; /∗ first half of mask of virtual mods to
66 take values from */
67 unsigned char vmods1; /∗ other half of mask of virtual mods to
68 take values from */
69 } XkbRedirectKeyAction;
70X Version 11 libX11 1.6.12 XkbSARedirectSetVModsMask(3)