xisetclientpointer(3) [debian man page]

XISETCLIENTPOINTER(3)													     XISETCLIENTPOINTER(3)

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.

								    05/15/2013						     XISETCLIENTPOINTER(3)

XIDEFINECURSOR(3)														 XIDEFINECURSOR(3)

NAME

       XIDefineCursor, XIUndefineCursor - define device cursors.

SYNOPSIS

       #include <X11/extensions/XInput2.h>

       int XIDefineCursor( Display *display,
			   int deviceid,
			   Window win,
			   Cursor cursor);

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

       cursor
	      Specifies the cursor that is to be displayed or None.

       deviceid
	      Specifies the device whose cursor is to change.

       display
	      Specifies the connection to the X server.

       win
	      Specifies the window.

DESCRIPTION

	   If a cursor is set, it will be used when the device's pointer
	   is in the window. If the cursor is None, it is equivalent to
	   XIUndefineCursor.

	   The deviceid must be a master pointer device or a BadDevice error is
	   returned.

	   XIDefineCursor can generate BadDevice, BadCursor and BadWindow.

	   The XIUndefineCursor function undoes the effect of a previous
	   XIDefineCursor for this window. When the pointer is in the
	   window, the window's default cursor will now be used. If no
	   default cursor is defined, the parent's cursor for this device
	   will be used (if defined) or the parent's default cursor will
	   be used.

	   XIDefineCursor and XIUndefineCursor are identical to
	   XDefineCursor and XUndefineCursor but specify the device
	   explicitly.

	   XIUndefineCursor can generate a BadDevice and a BadWindow
	   error.

DIAGNOSTICS

	   BadCursor
		  A value for a cursor argument does not name a defined
		  cursor.

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

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

       See also

	   XDefineCursor, XUndefineCursor

								    05/15/2013							 XIDEFINECURSOR(3)