NAME
XQueryPointer - get pointer coordinates
SYNTAX
Bool XQueryPointer(Display *_d_i_s_p_l_a_y, Window _w, Window
*_r_o_o_t___r_e_t_u_r_n, Window *_c_h_i_l_d___r_e_t_u_r_n, int
*_r_o_o_t___x___r_e_t_u_r_n, int *_r_o_o_t___y___r_e_t_u_r_n, int *_w_i_n___x___r_e_t_u_r_n,
int *_w_i_n___y___r_e_t_u_r_n, unsigned int *_m_a_s_k___r_e_t_u_r_n);
ARGUMENTS
-
_c_h_i_l_d___r_e_t_u_r_n
Returns the child window that the pointer is located in, if any.
-
-
_d_i_s_p_l_a_y
Specifies the connection to the X server.
-
-
_m_a_s_k___r_e_t_u_r_n
Returns the current state of the modifier keys and pointer buttons.
-
-
_r_o_o_t___r_e_t_u_r_n
Returns the root window that the pointer is in.
-
-
_r_o_o_t___x___r_e_t_u_r_n
-
-
_r_o_o_t___y___r_e_t_u_r_n
Return the pointer coordinates relative to the root window's origin.
-
-
_w
Specifies the window.
-
-
_w_i_n___x___r_e_t_u_r_n
-
-
_w_i_n___y___r_e_t_u_r_n
Return the pointer coordinates relative to the specified window.
-
DESCRIPTION
The
_X_Q_u_e_r_y_P_o_i_n_t_e_r
function returns the root window the pointer is logically on and the pointer
coordinates relative to the root window's origin.
If
_X_Q_u_e_r_y_P_o_i_n_t_e_r
returns
_F_a_l_s_e,
the pointer is not on the same screen as the specified window, and
_X_Q_u_e_r_y_P_o_i_n_t_e_r
returns
_N_o_n_e
to child_return and zero to win_x_return and win_y_return.
If
_X_Q_u_e_r_y_P_o_i_n_t_e_r
returns
_T_r_u_e,
the pointer coordinates returned to win_x_return and win_y_return
are relative to the origin of the specified window.
In this case,
_X_Q_u_e_r_y_P_o_i_n_t_e_r
returns the child that contains the pointer, if any,
or else
_N_o_n_e
to child_return.
_X_Q_u_e_r_y_P_o_i_n_t_e_r
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.
_X_Q_u_e_r_y_P_o_i_n_t_e_r
can generate a
_B_a_d_W_i_n_d_o_w
error.
DIAGNOSTICS
-
_B_a_d_W_i_n_d_o_w
-
A value for a Window argument does not name a defined Window.
SEE ALSO
XGetWindowAttributes(3X11),
XQueryTree(3X11)
_X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e