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