XWarpPointer(3X11)        XLIB FUNCTIONS       XWarpPointer(3X11)


NAME
       XWarpPointer - move pointer

SYNTAX
       XWarpPointer(display, srcw, destw, srcx, srcy,
       srcwidth, srcheight, destx,
                       desty)
               Display *display;
               Window srcw, destw;
               int srcx, srcy;
               unsigned int srcwidth, srcheight;
               int destx, desty;

ARGUMENTS
       destw    Specifies the destination window or None.

       destx
       desty    Specify the x and y coordinates within the des-
                 tination window.

       display   Specifies the connection to the X server.

       srcx
       srcy
       srcwidth
       srcheight
                 Specify a rectangle in the source window.

       srcw     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, however, it generates events just as if
       the user had instantaneously moved the pointer from one
       position to another.  Note that you cannot use XWarp-
       Pointer 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



X Version 11                Release 5                           1

XWarpPointer(3X11)        XLIB FUNCTIONS       XWarpPointer(3X11)


       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(3X11)
       Xlib - C Language X Interface














































X Version 11                Release 5                           2