<HTML>
<HEAD>
<TITLE></TITLE>
</HEAD>
<BODY>
<PRE>



XChangePointerDevice(3X11) X FUNCTIONS 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 BadDe_
       vice 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 Map_
       pingNotify  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  Bad_
       Match error.

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



X Version 11		   Release 6.1				1





XChangePointerDevice(3X11) X FUNCTIONS XChangePointerDevice(3X11)


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

       BadMatch	   This error may occur if  an	XChangePointerDe_
		   vice 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		   Release 6.1				2


</PRE>
</BODY>
</HTML>
