XWarpPointer(3X)                                 XWarpPointer(3X)



NAME
     XWarpPointer - controls input focus

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;

DESCRIPTION
     If dest-w is None, the XWarpPointer function moves the
     pointer to the coordinates by the offsets specified by the
     dest-x and dest-y arguments, relative to the current posi-
     tion of the pointer.  If dest-w is a window, XWarpPointer
     moves the pointer to the offsets specified by dest-x and
     dest-y relative to the origin of dest-w.  However, if src-w
     is a window, the move only takes place if the window speci-
     fied by src-w contains the pointer and if the pointer is
     contained in the specified rectangle of src-w.

     The src-x and src-y coordinates are relative to the origin
     of src-w.  If src-height is 0, it is replaced with the
     current height of src-w minus src-y.  If src-width is 0, 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 XWarpPointer to move
     the pointer outside the confine-to window of an active
     pointer grab.  An attempt to do so only moves the pointer as
     far as the closest edge of the confine-to window.

   Arguments
     This function accepts the following arguments:

     dest-w  Specifies the window ID of the destination window.

     dest-x, dest-y
             Specify the x and y coordinates within the destina-
             tion window.

     display Specifies the connection to the X server.

     src-width, src-height
             Specify the width and height of the source window.

     src-w   Specifies the window ID of the source window.



November, 1990                                                  1

XWarpPointer(3X)                                 XWarpPointer(3X)



     src-x, src-y
             Specify the x and y coordinates within the source
             window.

ERRORS
     BadWindow
             A value for a Window argument does not name a de-
             fined window.

SEE ALSO
     XSetInputFocus(3X)

     Xlib - C Language Interface











































2                                                  November, 1990