Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
XISETCLIENTPOINTER(3)					   XISETCLIENTPOINTER(3)

NAME
     XISetClientPointer,  XIGetClientPointer  - set or get the ClientPointer de-
     vice.

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 perceived 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/18/2026		   XISETCLIENTPOINTER(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XIGetClientPointer&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help