Man Linux: Main Page and Category List

NAME

       XISetClientPointer, XIGetClientPointer - set or get the ClientPointer
       device.

SYNOPSIS

       #include <X11/extensions/XInput2.h>

       XISetClientPointer( Display *display,
                           Window win,
                           int deviceid);

       Bool XIGetClientPointer( Display *display,
                                Window win,
                                int *device);

       display
              Specifies the connection to the X server.

       win
              Specifies a window belonging to the client. May be None.

       deviceid
              Specifies the ClientPointer device.

DESCRIPTION

           The ClientPointer is the device that is percieved to be the
           core pointer for non-XI protocol requests and replies. Each
           time a protocol message needs device-dependent data and the
           device is not explicitly given, the ClientPointer device is
           used to obtain the data. For example, a XQueryPointer request
           will return the coordinates of the ClientPointer.

           XISetClientPointer request sets the ClientPointer device for
           the client that owns the given window. If win is None, the
           requesting client´s ClientPointer is set to the device
           specified with deviceid. Only master pointer devices can be set
           as ClientPointer.

           XISetClientPointer and can generate a BadDevice and a BadWindow
           error.

           The XIGetClientPointer request returns the ClientPointer´s
           device ID for the client that owns the given window. If win is
           None, the requesting client´s ClientPointer is returned.

           win may be a client ID instead of a window.

           XIGetClientPointer can generate a BadWindow error.

DIAGNOSTICS

           BadDevice
                  An invalid device was specified. The device does not
                  exist or is not a master pointer device.

           BadWindow
                  A value for a Window argument does not name a defined
                  window.

[FIXME: source]                   10/02/2009