XQueryPointer(3X11)           SDK X11 R4.11MU05          XQueryPointer(3X11)


NAME
       XQueryPointer - get pointer coordinates

SYNTAX
       Bool XQueryPointer(display, w, rootreturn, childreturn,
       rootxreturn, rootyreturn,
                            winxreturn, winyreturn, maskreturn)
             Display *display;
             Window w;
             Window *rootreturn, *childreturn;
             int *rootxreturn, *rootyreturn;
             int *winxreturn, *winyreturn;
             unsigned int *maskreturn;

ARGUMENTS
       childreturn
                 Returns the child window that the pointer is located in, if
                 any.

       display   Specifies the connection to the X server.

       maskreturn
                 Returns the current state of the modifier keys and pointer
                 buttons.

       rootreturn
                 Returns the root window that the pointer is in.

       rootxreturn
       rootyreturn
                 Return the pointer coordinates relative to the root
                 window's origin.

       w         Specifies the window.

       winxreturn
       winyreturn
                 Return the pointer coordinates relative to the specified
                 window.

DESCRIPTION
       The XQueryPointer function returns the root window the pointer is
       logically on and the pointer coordinates relative to the root
       window's origin.  If XQueryPointer returns False, the pointer is not
       on the same screen as the specified window, and XQueryPointer returns
       None to child_return and zero to win_x_return and win_y_return.  If
       XQueryPointer returns True, the pointer coordinates returned to
       win_x_return and win_y_return are relative to the origin of the
       specified window.  In this case, XQueryPointer returns the child that
       contains the pointer, if any, or else None to child_return.

       XQueryPointer returns the current logical state of the keyboard
       buttons and the modifier keys in mask_return.  It sets mask_return to
       the bitwise inclusive OR of one or more of the button or modifier key
       bitmasks to match the current state of the mouse buttons and the
       modifier keys.

       XQueryPointer can generate a BadWindow error.

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

SEE ALSO
       XGetWindowAttributes(3X11), XQueryTree(3X11)
       Xlib - C Language X Interface


Licensed material--property of copyright holder(s)