XQueryPointer

TriggerTek Logo
abcdefghijklmnopqrstuvwxyz_
XQueryPointer(3X11)		XLIB FUNCTIONS		  XQueryPointer(3X11)



NAME
       XQueryPointer - get pointer coordinates

SYNTAX
       Bool XQueryPointer(Display *display, Window w, Window *root_return,
	      Window *child_return, int *root_x_return, int *root_y_return,
	      int *win_x_return, int *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 X 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 log-
       ically 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 XQuery-
       Pointer 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 but-
       tons 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 bit-
       masks 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 Win-
		 dow.

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



							  XQueryPointer(3X11)