Manual pages › X Window and screen libraries (3X)

XQPointer(3X)

get pointer coordinates

From the original Amiga UNIX 2.1 manual. Some things it mentions may not be in this release.

NAME

XQueryPointer - get pointer coordinates

SYNTAX

Bool XQueryPointer(display, w, root_return, child_return,
root_x_return,
     root_y_return, win_x_return, win_y_return, mask_return)
      Display *display;
      Window w;
      Window *root_return, *child_return;
      int *root_x_return, *root_y_return;
      int *win_x_return, *win_y_return;
      unsigned int *mask_return;

ARGUMENTS

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

display   Specifies the connection to the XWIN server.

mask_return

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

root_return

Returns the root window that the pointer is in.

root_x_return
root_y_return
          Return the pointer coordinates relative to the
          root window's origin.

w         Specifies the window.

win_x_return
win_y_return
          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 speci-
     fied 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.

XWIN 3.0               Last change: 9/1/88                 .ie t

     XQueryPointer returns the current logical state of the key-
     board 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