XtSetSensitive(3Xt) AIX (XT FUNCTIONS) XtSetSensitive(3Xt) 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 chil- dren 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 chil- dren 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 Rev. Release 3 Page 1