NAME
XSelectInput - select input events
SYNTAX
int XSelectInput(Display *_d_i_s_p_l_a_y, Window _w, long
_e_v_e_n_t___m_a_s_k);
ARGUMENTS
-
_d_i_s_p_l_a_y
Specifies the connection to the X server.
-
-
_e_v_e_n_t___m_a_s_k
Specifies the event mask.
-
-
_w
Specifies the window whose events you are interested in.
-
DESCRIPTION
The
_X_S_e_l_e_c_t_I_n_p_u_t
function requests that the X server report the events associated with the
specified event mask.
Initially, X will not report any of these events.
Events are reported relative to a window.
If a window is not interested in a device event, it usually propagates to
the closest ancestor that is interested,
unless the do_not_propagate mask prohibits it.
Setting the event-mask attribute of a window overrides any previous call
for the same window but not for other clients.
Multiple clients can select for the same events on the same window
with the following restrictions:
-
·
Multiple clients can select events on the same window because their event masks
-
are disjoint.
When the X server generates an event, it reports it
to all interested clients.
-
·
Only one client at a time can select
-
_C_i_r_c_u_l_a_t_e_R_e_q_u_e_s_t,
_C_o_n_f_i_g_u_r_e_R_e_q_u_e_s_t,
or
_M_a_p_R_e_q_u_e_s_t
events, which are associated with
the event mask
_S_u_b_s_t_r_u_c_t_u_r_e_R_e_d_i_r_e_c_t_M_a_s_k.
-
·
Only one client at a time can select
-
a
_R_e_s_i_z_e_R_e_q_u_e_s_t
event, which is associated with
the event mask
_R_e_s_i_z_e_R_e_d_i_r_e_c_t_M_a_s_k.
-
·
Only one client at a time can select a
-
_B_u_t_t_o_n_P_r_e_s_s
event, which is associated with
the event mask
_B_u_t_t_o_n_P_r_e_s_s_M_a_s_k.
The server reports the event to all interested clients.
_X_S_e_l_e_c_t_I_n_p_u_t
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
_X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e