XKB FUNCTIONS XkbSARedirectSetVMods(3x11)
NAME
XkbSARedirectSetVMods - Sets the vmods0 and vmods1 of act
from vSYNOPSIS
cc [ flag... ] file... -lX11 [ library... ]
void XkbSARedirectSetVMods (XkbRedirectKeyAction act,
unsigned int v); ARGUMENTS- act
action in which to set vmods- v new value for virtual modifiers
DESCRIPTION
Actions associated with the XkbRedirectKeyAction structure generate KeyPress and KeyRelease events containing a keycode different from the key that was pressed or released. The type field for the XkbRedirectKeyAction structure shouldalways be XkbSA_RedirectKey. Key presses cause a KeyPress
event for the key specified by the new_key field instead of
the actual key. The state reported in this event reports the current effective modifiers changed as follows: any realmodifiers selected by the mods_mask field are set to
corresponding values from the mods field. Any real modifiersbound to the virtual modifiers specified by the vmods_mask0
and vmods_mask1 fields are either set or cleared, depending
on the corresponding values in the vmods0 and vmods1 fields.If the real and virtual modifier definitions specify con-
flicting values for a single modifier, the real modifier definition has priority. Key releases cause a KeyRelease event for the key specifiedby the new_key field instead of the actual key. The state
for this event consists of the effective keyboard modifiers at the time of the release, changed as described previously.The XkbSA_RedirectKey action normally redirects to another
key on the same device as the key that caused the event, unless that device does not belong to the input extension KeyClass, in which case this action causes an event on thecore keyboard device. (The input extension categorizes dev-
ices by breaking them into classes. Keyboards, and other input devices with keys, are classified as KeyClass devices by the input extension.)The vmods_mask0 and vmods_mask1 fields actually represent
one vmods_mask value. Xkb provides macros to convert between
the two formats. X Version 11 Last change: libX11 1.3.5 1XKB FUNCTIONS XkbSARedirectSetVMods(3x11)
XkbSARedirectSetVModsMask sets the vmods0 and vmods1 of act
from v. STRUCTUREStypedef struct_XkbRedirectKeyAction {
unsigned char type; /* XkbSA_RedirectKey */
unsigned char new_key; /* keycode to be put in event */
unsigned char mods_mask; /* mask of real mods to be reset */
unsigned char mods; /* mask of real mods to take values from */unsigned char vmods_mask0; /* first half of mask of virtual mods to be reset */
unsigned char vmods_mask1; /* other half of mask of virtual mods to be reset */
unsigned char vmods0; /* first half of mask of virtual mods to take values from */ unsigned char vmods1; /* other half of mask of virtual mods to take values from */ } XkbRedirectKeyAction;ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | x11/library/libx11 ||_____________________________|_____________________________|
| Interface Stability | Committed ||_____________________________|_____________________________|
| MT-Level | See XInitThreads(3X11) |
|_____________________________|_____________________________|
X Version 11 Last change: libX11 1.3.5 2