


XSelectInput(3X11)					   XSelectInput(3X11)
X11R5									X11R5



NAME
  XSelectInput - select	input events

SYNTAX

  XSelectInput(_d_i_s_p_l_a_y,	_w, _e_v_e_n_t__m_a_s_k)
	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:

  oo++    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.

  oo++    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.

  oo++    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.

  oo++    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
































































