XChangeKeyboardDevice(3)   X FUNCTIONS   XChangeKeyboardDevice(3)



NAME
       XChangeKeyboardDevice - change which device is used as the
       X keyboard

SYNTAX
       Status  XChangeKeyboardDevice(Display  *display,   XDevice
              *device);

ARGUMENTS
       display     Specifies the connection to the X server.

       device      Specifies  the device to be used as the X key-
                   board.

DESCRIPTION
       The XChangeKeyboardDevice request causes the server to use
       the  specified  device as the X keyboard.  The device must
       have been previously opened by the requesting  client  via
       XOpenDevice  or a BadDevice error will result.  The device
       must support input class Keys, or a  BadMatch  error  will
       result.   If  the  server  implementation does not support
       using the requested device as the X keyboard, a  BadDevice
       error will result.

       If  the  specified  device  is  grabbed by another client,
       AlreadyGrabbed is returned.  If the  specified  device  is
       frozen   by  a  grab  on  another  device,  GrabFrozen  is
       returned.   If  the  request  is  successful,  Success  is
       returned.

       If  the  request  succeeds,  a ChangeDeviceNotify event is
       sent to all clients that have selected that event.  A Map-
       pingNotify event with request = MappingKeyboard is sent to
       all clients.  The specified device becomes the X  keyboard
       and  the  old  X  keyboard  becomes accessible through the
       input extension protocol requests.

       XChangeKeyboardDevice can generate a BadDevice or  a  Bad-
       Match error.

DIAGNOSTICS
       BadDevice   An  invalid  device was specified.  The speci-
                   fied device  does  not  exist,  has  not  been
                   opened  by  this  client via XOpenInputDevice,
                   or  is  already  one  of  the  core  X  device
                   (pointer  or  keyboard).   This error may also
                   occur if the server  implementation  does  not
                   support  using  the  specified device as the X
                   keyboard.

       BadMatch    This error may occur if an  XChangeKeyboardDe-
                   vice request was made specifying a device that
                   has no keys.

SEE ALSO
       XChangePointerDevice
       Programming With Xlib



X Version 11               libXi 1.1.3   XChangeKeyboardDevice(3)