xwarppointer(3) [hpux man page]

XWarpPointer()															    XWarpPointer()

Name
  XWarpPointer - move the pointer to another point on the screen.

Synopsis
  XWarpPointer(display, src_w, dest_w, src_x, src_y, src_width, src_height, dest_x, dest_y)
	Display *display;
	Window src_w, dest_w;
	int src_x, src_y;
	unsigned int src_width, src_height;
	int dest_x, dest_y;

Arguments
  display    Specifies a connection to an X server; returned from XOpenDisplay().

  src_w      Specifies the ID of the source window.  You can also pass None.

  dest_w     Specifies the ID of the destination window.  You can also pass None.

  src_x      Specify the x and y coordinates within the source window.	These are used with src_width and src_height to determine the rectan-
  src_y      gle the pointer must be in in order to be moved.  They are not the present pointer position.  If src_w is	None,  these  coordi-
	     nates are relative to the root window of src_w.

  src_width  Specify the width and height in pixels of the source area.  Used with src_x and src_y.
  src_height
  dest_x     Specify the destination x and y coordinates within the destination window.  If dest_w is None, these coordinates are relative to
  dest_y     the root window of dest_w.

Description
  XWarpPointer() moves the pointer suddenly from one point on the screen to another.

  If dest_w is a window, XWarpPointer() moves the pointer to [dest_x, dest_y] relative to the destination  window's  origin.   If  dest_w  is
  None, XWarpPointer() moves the pointer according to the offsets [dest_x, dest_y] relative to the current position of the pointer.

  If  src_w is None, the move is independent of the current cursor position (dest_x and dest_y use global coordinates).  If the source window
  is not None, the move only takes place if the pointer is currently contained in a visible portion of the rectangle  of  the  source  window
  (including its inferiors) specified by src_x, src_y, src_width and src_height.  If src_width is zero (0), the pointer must be between src_x
  and the right edge of the window to be moved.  If src_height is zero (0), the pointer must be between src_y and the bottom edge of the win-
  dow to be moved.

  XWarpPointer() cannot be used to move the pointer outside the confine_to window of an active pointer grab.  If such an attempt is made, the
  pointer is moved to the point on the border of the confine_to window nearest the requested destination.

  XWarpPointer() generates events as if the user had (instantaneously) moved the pointer.

  This function should not be used unless absolutely necessary, and then only in tightly controlled,  predictable  situations.	 It  has  the
  potential to confuse the user.

Errors
  BadWindow

See Also
  XChangeActivePointerGrab(),  XChangePointerControl(),  XGetPointerControl(),	XGetPointerMapping(),  XGrabPointer(), XQueryPointer(), XSet-
  PointerMapping(), XUngrabPointer().

Xlib - Pointer															    XWarpPointer()

Check Out this Related Man Page

XWarpPointer(3) 						  XLIB FUNCTIONS						   XWarpPointer(3)

NAME

       XWarpPointer - move pointer

SYNTAX

       int XWarpPointer(Display *display, Window src_w, Window dest_w, int src_x, int src_y, unsigned int src_width, unsigned int src_height, int
	      dest_x, int dest_y);

ARGUMENTS

       dest_w	 Specifies the destination window or None.

       dest_x
       dest_y	 Specify the x and y coordinates within the destination window.

       display	 Specifies the connection to the X server.

       src_x
       src_y
       src_width
       src_height
		 Specify a rectangle in the source window.

       src_w	 Specifies the source window or None.

DESCRIPTION

       If dest_w is None, XWarpPointer moves the pointer by the offsets (dest_x, dest_y) relative to the current position of the pointer.  If
       dest_w is a window, XWarpPointer moves the pointer to the offsets (dest_x, dest_y) relative to the origin of dest_w.  However, if src_w is
       a window, the move only takes place if the window src_w contains the pointer and if the specified rectangle of src_w contains the pointer.

       The src_x and src_y coordinates are relative to the origin of src_w.  If src_height is zero, it is replaced with the current height of
       src_w minus src_y.  If src_width is zero, it is replaced with the current width of src_w minus src_x.

       There is seldom any reason for calling this function.  The pointer should normally be left to the user.	If you do use this function, how-
       ever, it generates events just as if the user had instantaneously moved the pointer from one position to another.  Note that you cannot use
       XWarpPointer to move the pointer outside the confine_to window of an active pointer grab.  An attempt to do so will only move the pointer
       as far as the closest edge of the confine_to window.

       XWarpPointer can generate a BadWindow error.

DIAGNOSTICS

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

SEE ALSO

       XSetInputFocus(3)
       Xlib - C Language X Interface

X Version 11							   libX11 1.6.0 						   XWarpPointer(3)

Linux and UNIX Man Pages

xwarppointer(3) [hpux man page]

Check Out this Related Man Page