Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

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.
  src_y	     These are used with src_width and	src_height  to	determine
	     the  rectangle  the pointer must be in in order to be moved.
	     They are not the present  pointer	position.   If	src_w  is
	     None,  these  coordinates are relative to the root window of
	     src_w.

  src_width  Specify the width and height in pixels of the  source  area.
  src_height Used with src_x and src_y.

  dest_x     Specify  the destination x and y coordinates within the des‐
  dest_y     tination window.  If dest_w is None, these	 coordinates  are
	     relative to 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 posi‐
  tion (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 con‐
  tained 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
  window to be moved.

  XWarpPointer()  cannot  be  used  to	move the pointer outside the con‐
  fine_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 win‐
  dow 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  poten‐
  tial to confuse the user.

Errors
  BadWindow

See Also
  XChangeActivePointerGrab(),	XChangePointerControl(),  XGetPointerCon‐
  trol(), XGetPointerMapping(),	 XGrabPointer(),  XQueryPointer(),  XSet‐
  PointerMapping(), XUngrabPointer().

Xlib - Pointer							XWarpPointer()

Vote for polarhome