XChangePointerDevice(3X11)

NAME
       XChangePointerDevice  -  change  which  device  is  the  X
       pointer

SYNTAX
       Status XChangePointerDevice(display, device xaxis, yaxis)
             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