XChangePointerDevice.3XI.z(3X11)



     X Version 11 (Release 5)               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 BadDevice
          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
          MappingNotify 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 BadMatch
          error.

     DIAGNOSTICS
          BadDevice   An invalid device was specified.  The specified
                      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



     Licensed material--property of copyright holder(s)         Page 1



                         X Version 11 (ReleaX
sC
eh5
a)
ngePointerDevice(3X11)



                      server implementation does not support using the
                      specified device as the X pointer.

          BadMatch    This error may occur if an XChangePointerDevice
                      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











































     Licensed material--property of copyright holder(s)         Page 2

Museum