


XtSetSensitive(3Xt)					  XtSetSensitive(3Xt)
X11R5									X11R5



NAME
  XtSetSensitive, XtIsSensitive	- set and check	a widget's sensitivity state

SYNTAX
  void XtSetSensitive(_w, _s_e_n_s_i_t_i_v_e)
	Widget _w;
	Boolean	_s_e_n_s_i_t_i_v_e;

  Boolean XtIsSensitive(_w)
       Widget _w;

ARGUMENTS

  _s_e_n_s_i_t_i_v_e Specifies a	Boolean	value that indicates whether the widget
	    should receive keyboard and	pointer	events.

  _w	    Specifies the widget.

DESCRIPTION
  The _X_t_S_e_t_S_e_n_s_i_t_i_v_e function first calls _X_t_S_e_t_V_a_l_u_e_s on the current widget
  with an argument list	specifying that	the sensitive field should change to
  the new value.  It then recursively propagates the new value down the
  managed children tree	by calling _X_t_S_e_t_V_a_l_u_e_s on each child to	set the
  ancestor_sensitive to	the new	value if the new values	for sensitive and the
  child's ancestor_sensitive are not the same.

  _X_t_S_e_t_S_e_n_s_i_t_i_v_e calls _X_t_S_e_t_V_a_l_u_e_s to change sensitive and
  ancestor_sensitive.  Therefore, when one of these changes, the widget's
  set_values procedure should take whatever display actions are	needed (for
  example, greying out or stippling the	widget).

  _X_t_S_e_t_S_e_n_s_i_t_i_v_e maintains the invariant that if parent	has either sensitive
  or ancestor_sensitive	_F_a_l_s_e, then all	children have ancestor_sensitive
  _F_a_l_s_e.

  The _X_t_I_s_S_e_n_s_i_t_i_v_e function returns _T_r_u_e or _F_a_l_s_e to indicate whether or not
  user input events are	being dispatched.  If both core.sensitive and
  core.ancestor_sensitive are _T_r_u_e, _X_t_I_s_S_e_n_s_i_t_i_v_e returns _T_r_u_e;	otherwise, it
  returns _F_a_l_s_e.

SEE ALSO
  _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	delim off















