


XtAddEventHandler(3Xt)				       XtAddEventHandler(3Xt)
X11R5									X11R5



NAME
  XtAddEventHandler, XtAddRawEventHandler, XtRemoveEventHandler, XtRemo-
  veRawEventHandler - add and remove event handlers

SYNTAX
  void XtAddEventHandler(_w, _e_v_e_n_t__m_a_s_k,	_n_o_n_m_a_s_k_a_b_l_e, _p_r_o_c, _c_l_i_e_n_t__d_a_t_a)
	Widget _w;
	EventMask _e_v_e_n_t__m_a_s_k;
	Boolean	_n_o_n_m_a_s_k_a_b_l_e;
	XtEventHandler _p_r_o_c;
	XtPointer _c_l_i_e_n_t__d_a_t_a;

  void XtAddRawEventHandler(_w, _e_v_e_n_t__m_a_s_k, _n_o_n_m_a_s_k_a_b_l_e,	_p_r_o_c, _c_l_i_e_n_t__d_a_t_a)
	Widget _w;
	EventMask _e_v_e_n_t__m_a_s_k;
	Boolean	_n_o_n_m_a_s_k_a_b_l_e;
	XtEventHandler _p_r_o_c;
	XtPointer _c_l_i_e_n_t__d_a_t_a;

  void XtRemoveEventHandler(_w, _e_v_e_n_t__m_a_s_k, _n_o_n_m_a_s_k_a_b_l_e,	_p_r_o_c, _c_l_i_e_n_t__d_a_t_a)
	Widget _w;
	EventMask _e_v_e_n_t__m_a_s_k;
	Boolean	_n_o_n_m_a_s_k_a_b_l_e;
	XtEventHandler _p_r_o_c;
	XtPointer _c_l_i_e_n_t__d_a_t_a;

  void XtRemoveRawEventHandler(_w, _e_v_e_n_t__m_a_s_k, _n_o_n_m_a_s_k_a_b_l_e, _p_r_o_c, _c_l_i_e_n_t__d_a_t_a)
	Widget _w;
	EventMask _e_v_e_n_t__m_a_s_k;
	Boolean	_n_o_n_m_a_s_k_a_b_l_e;
	XtEventHandler _p_r_o_c;
	XtPointer _c_l_i_e_n_t__d_a_t_a;

ARGUMENTS

  _c_l_i_e_n_t__d_a_t_a
	    Specifies additional data to be passed to the client's event
	    handler.

  _e_v_e_n_t__m_a_s_k
	    Specifies the event	mask for which to call or unregister this
	    procedure.

  _n_o_n_m_a_s_k_a_b_l_e
	    Specifies a	Boolean	value that indicates whether this procedure
	    should be called or	removed	on the nonmaskable events (_G_r_a_-
	    _p_h_i_c_s_E_x_p_o_s_e, _N_o_E_x_p_o_s_e, _S_e_l_e_c_t_i_o_n_C_l_e_a_r, _S_e_l_e_c_t_i_o_n_R_e_q_u_e_s_t, _S_e_l_e_c_-
	    _t_i_o_n_N_o_t_i_f_y,	_C_l_i_e_n_t_M_e_s_s_a_g_e, and _M_a_p_p_i_n_g_N_o_t_i_f_y).

  _p_r_o_c	    Specifies the procedure that is to be added	or removed.

  _w	    Specifies the widget for which this	event handler is being
	    registered.

DESCRIPTION
  The _X_t_A_d_d_E_v_e_n_t_H_a_n_d_l_e_r	function registers a procedure with the	dispatch
  mechanism that is to be called when an event that matches the	mask occurs
  on the specified widget.  If the procedure is	already	registered with	the
  same client_data, the	specified mask is ORed into the	existing mask.	If
  the widget is	realized, _X_t_A_d_d_E_v_e_n_t_H_a_n_d_l_e_r calls _X_S_e_l_e_c_t_I_n_p_u_t,	if necessary.

  The _X_t_A_d_d_R_a_w_E_v_e_n_t_H_a_n_d_l_e_r function is similar to _X_t_A_d_d_E_v_e_n_t_H_a_n_d_l_e_r except
  that it does not affect the widget's mask and	never causes an	_X_S_e_l_e_c_t_I_n_p_u_t
  for its events.  Note	that the widget	might already have those mask bits
  set because of other nonraw event handlers registered	on it.

  The _X_t_A_d_d_R_a_w_E_v_e_n_t_H_a_n_d_l_e_r function is similar to _X_t_A_d_d_E_v_e_n_t_H_a_n_d_l_e_r except
  that it does not affect the widget's mask and	never causes an	_X_S_e_l_e_c_t_I_n_p_u_t
  for its events.  Note	that the widget	might already have those mask bits
  set because of other nonraw event handlers registered	on it.

  The _X_t_R_e_m_o_v_e_R_a_w_E_v_e_n_t_H_a_n_d_l_e_r function stops the specified procedure from
  receiving the	specified events.  Because the procedure is a raw event
  handler, this	does not affect	the widget's mask and never causes a call on
  _X_S_e_l_e_c_t_I_n_p_u_t.

SEE ALSO
  XtAppNextEvent(3Xt), XtBuildEventMask(3Xt)
  _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s - _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
  _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e












































