1XChangeKeyboardDevice(3)          X FUNCTIONS         XChangeKeyboardDevice(3)
2
3
4

NAME

6       XChangeKeyboardDevice - change which device is used as the X keyboard
7

SYNTAX

9       Status XChangeKeyboardDevice(Display *display, XDevice *device);
10

ARGUMENTS

12       display     Specifies the connection to the X server.
13
14       device      Specifies the device to be used as the X keyboard.
15

DESCRIPTION

17       The  XChangeKeyboardDevice  request causes the server to use the speci‐
18       fied device as the X keyboard.  The device must  have  been  previously
19       opened  by  the  requesting client via XOpenDevice or a BadDevice error
20       will result.  The device must support input class Keys, or  a  BadMatch
21       error will result.  If the server implementation does not support using
22       the requested device as the X keyboard, a BadDevice error will result.
23
24       If the specified device is grabbed by another client, AlreadyGrabbed is
25       returned.   If  the  specified  device  is  frozen by a grab on another
26       device, GrabFrozen is returned.  If the request is successful,  Success
27       is returned.
28
29       If  the  request  succeeds,  a  ChangeDeviceNotify event is sent to all
30       clients that have selected that  event.   A  MappingNotify  event  with
31       request = MappingKeyboard is sent to all clients.  The specified device
32       becomes the X keyboard  and  the  old  X  keyboard  becomes  accessible
33       through the input extension protocol requests.
34
35       XChangeKeyboardDevice can generate a BadDevice or a BadMatch error.
36

DIAGNOSTICS

38       BadDevice   An invalid device was specified.  The specified device does
39                   not exist, has not been opened by this client via  XOpenIn‐
40                   putDevice,  or is already one of the core X device (pointer
41                   or keyboard).  This error may  also  occur  if  the  server
42                   implementation  does not support using the specified device
43                   as the X keyboard.
44
45       BadMatch    This error may occur if  an  XChangeKeyboardDevice  request
46                   was made specifying a device that has no keys.
47

SEE ALSO

49       XChangePointerDevice
50       Programming With Xlib
51
52
53
54X Version 11                      libXi 1.1.1         XChangeKeyboardDevice(3)
Impressum