XChangePointerDevice(3)    X FUNCTIONS    XChangePointerDevice(3)



NAME
       XChangePointerDevice  -  change  which  device  is  the  X
       pointer

SYNTAX
       Status  XChangePointerDevice(Display   *display,   XDevice
              *device, int xaxis, int yaxis);

ARGUMENTS
       display     Specifies the connection to the X server.

       device      Specifies  the  device  to  be  used  as the X
                   pointer.

       xaxis       Specifies the axis of the device to be used as
                   the X pointer x-axis.

       yaxis       Specifies the axis of the device to be used as
                   the X pointer y-axis.

DESCRIPTION
       The XChangePointerDevice request causes the server to  use
       the  specified  device  as the X pointer.  The device must
       have been opened by the client via XOpenDevice or a BadDe-
       vice  error  will  result.   The device must support input
       class Valuators or a BadMatch error will result.   If  the
       implementation  does  not  support  use  of  the specified
       device as the X pointer, 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 = MappingPointer is sent  to
       all  clients.  The specified device becomes the X pointer,
       and the old X pointer becomes accessible through the input
       extension protocol requests.

       XChangePointerDevice  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 input devices
                   (pointer or keyboard).  This  error  may  also
                   occur  if  the  server implementation does not
                   support using the specified device  as  the  X
                   pointer.

       BadMatch    This  error  may occur if an XChangePointerDe-
                   vice request was made specifying a device that
                   has  less  than two valuators, or specifying a
                   valuator index beyond the range  supported  by
                   the device.

SEE ALSO
       XChangeKeyboardDevice
       Programming With Xlib



X Version 11               libXi 1.1.3    XChangePointerDevice(3)