XkbLockModifiers
Section: XKB FUNCTIONS (3)
Updated: libX11 1.3
Index
Return to Main Contents
 
NAME
XkbLockModifiers -  Locks and unlocks any of the eight real keyboard modifiers
 
SYNOPSIS
- 
Bool XkbLockModifiers
(Display *display,
unsigned int device_spec,
unsigned int affect,
unsigned int values);
 
ARGUMENTS
- display
- 
- connection to the X server 
- device_spec
- 
device ID, or XkbUseCoreKbd
- affect
- 
mask of real modifiers whose lock state is to change
- values
- 
1 => lock, 0 => unlock; only for modifiers selected by affect
DESCRIPTION
XkbLockModifiers 
sends a request to the server to lock the real modifiers 
selected by both 
affect 
and 
values
and to unlock the real modifiers selected by 
affect, 
but not selected by 
values. XkbLockModifiers 
does not wait for a reply from the server. It returns True if the request was 
sent, and False otherwise.
The functions in this section that change the use of modifiers use a mask in the 
parameter affect. It is a bitwise inclusive OR of the legal modifier masks: 
| Table 1 Real Modifier Masks 
 | 
| 
 | 
| Mask 
 | 
| 
 | 
| ShiftMask 
 | 
| LockMask 
 | 
| ControlMask 
 | 
| Mod1Mask 
 | 
| Mod2Mask 
 | 
| Mod3Mask 
 | 
| Mod4Mask 
 | 
| Mod5Mask 
 | 
 
RETURN VALUES
- True
- 
The 
XkbLockModifiers 
function returns True if a request is sent to the server to lock the real 
modifiers 
selected by both 
affect 
and 
values
and to unlock the real modifiers selected by 
affect, 
but not selected by 
values.
- False
- 
The 
XkbLockModifiers 
function returns False if the request was not sent.