Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

X11R7.4 - man page for xchangepointerdevice (x11r4 section 3)

XChangePointerDevice(3) 		   X FUNCTIONS			  XChangePointerDevice(3)

NAME
       XChangePointerDevice - change which device is the X pointer

SYNTAX
       Status XChangePointerDevice(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 acces-
       sible 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
		   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

X Version 11				   libXi 1.2.1			  XChangePointerDevice(3)


All times are GMT -4. The time now is 03:10 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password