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