home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xtsetsensitive.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  2.3 KB  |  67 lines
  1.  
  2.  
  3.  
  4. XtSetSensitive(3Xt)       XT FUNCTIONS          XtSetSensitive(3Xt)
  5.  
  6.  
  7. NNAAMMEE
  8.        XtSetSensitive, XtIsSensitive - set and check a widget's
  9.        sensitivity state
  10.  
  11. SSYYNNTTAAXX
  12.        void XtSetSensitive(_w, _s_e_n_s_i_t_i_v_e)
  13.          Widget _w;
  14.          Boolean _s_e_n_s_i_t_i_v_e;
  15.  
  16.        Boolean XtIsSensitive(_w)
  17.         Widget _w;
  18.  
  19. AARRGGUUMMEENNTTSS
  20.        _s_e_n_s_i_t_i_v_e Specifies a Boolean value that indicates whether
  21.          the widget should receive keyboard and pointer
  22.          events.
  23.  
  24.        _w     Specifies the widget.
  25.  
  26. DDEESSCCRRIIPPTTIIOONN
  27.        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
  28.        current widget with an argument list specifying that the
  29.        sensitive field should change to the new value.    It then
  30.        recursively propagates the new value down the managed
  31.        children tree by calling _X_t_S_e_t_V_a_l_u_e_s on each child to set
  32.        the ancestor_sensitive to the new value if the new values
  33.        for sensitive and the child's ancestor_sensitive are not
  34.        the same.
  35.  
  36.        _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
  37.        ancestor_sensitive.  Therefore, when one of these changes,
  38.        the widget's set_values procedure should take whatever
  39.        display actions are needed (for example, greying out or
  40.        stippling the widget).
  41.  
  42.        _X_t_S_e_t_S_e_n_s_i_t_i_v_e maintains the invariant that if parent has
  43.        either sensitive or ancestor_sensitive _F_a_l_s_e, then all
  44.        children have ancestor_sensitive _F_a_l_s_e.
  45.  
  46.        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 indi-
  47.        cate whether or not user input events are being dis-
  48.        patched.     If both core.sensitive and
  49.        core.ancestor_sensitive are _T_r_u_e, _X_t_I_s_S_e_n_s_i_t_i_v_e returns
  50.        _T_r_u_e; otherwise, it returns _F_a_l_s_e.
  51.  
  52. SSEEEE AALLSSOO
  53.        _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
  54.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.