home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xtrealizewidget.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  3.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XtRealizeWidget(3Xt)       XT FUNCTIONS         XtRealizeWidget(3Xt)
  5.  
  6.  
  7. NNAAMMEE
  8.        XtRealizeWidget, XtIsRealized, XtUnrealizeWidget - realize
  9.        and unrealize widgets
  10.  
  11. SSYYNNTTAAXX
  12.        void XtRealizeWidget(_w)
  13.          Widget _w;
  14.  
  15.        Boolean XtIsRealized(_w)
  16.          Widget _w;
  17.  
  18.        void XtUnrealizeWidget(_w)
  19.          Widget _w;
  20.  
  21. AARRGGUUMMEENNTTSS
  22.        _w     Specifies the widget.
  23.  
  24. DDEESSCCRRIIPPTTIIOONN
  25.        If the widget is already realized, _X_t_R_e_a_l_i_z_e_W_i_d_g_e_t simply
  26.        returns.     Otherwise, it performs the following:
  27.  
  28.        +o    Binds all action names in the widget's translation
  29.         table to procedures (see Section 10.1.2).
  30.  
  31.        +o    Makes a post-order traversal of the widget tree
  32.         rooted at the specified widget and calls the
  33.         change_managed procedure of each composite widget
  34.         that has one or more managed children.
  35.  
  36.        +o    Constructs an _X_S_e_t_W_i_n_d_o_w_A_t_t_r_i_b_u_t_e_s structure filled
  37.         in with information derived from the _C_o_r_e widget
  38.         fields and calls the realize procedure for the wid-
  39.         get, which adds any widget-specific attributes and
  40.         creates the X window.
  41.  
  42.        +o    If the widget is not a subclass of
  43.         _c_o_m_p_o_s_i_t_e_W_i_d_g_e_t_C_l_a_s_s, _X_t_R_e_a_l_i_z_e_W_i_d_g_e_t returns; other-
  44.         wise, it continues and performs the following:
  45.  
  46.         -     Descends recursively to each of the widget's
  47.          managed children and calls the realize proce-
  48.          dures.     Primitive widgets that instantiate chil-
  49.          dren are responsible for realizing those chil-
  50.          dren themselves.
  51.  
  52.         -     Maps all of the managed children windows that
  53.          have mapped_when_managed _T_r_u_e.     (If a widget is
  54.          managed but mapped_when_managed is _F_a_l_s_e, the
  55.          widget is allocated visual space but is not dis-
  56.          played.  Some people seem to like this to indi-
  57.          cate certain states.)
  58.  
  59.        If the widget is a top-level shell widget (that is, it has
  60.        no parent), and mapped_when_managed is _T_r_u_e,
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XtRealizeWidget(3Xt)       XT FUNCTIONS         XtRealizeWidget(3Xt)
  71.  
  72.  
  73.        _X_t_R_e_a_l_i_z_e_W_i_d_g_e_t maps the widget window.
  74.  
  75.        The _X_t_I_s_R_e_a_l_i_z_e_d function returns _T_r_u_e if the widget has
  76.        been realized, that is, if the widget has a nonzero X win-
  77.        dow ID.
  78.  
  79.        Some widget procedures (for example, set_values) might
  80.        wish to operate differently after the widget has been
  81.        realized.
  82.  
  83.        The _X_t_U_n_r_e_a_l_i_z_e_W_i_d_g_e_t function destroys the windows of an
  84.        existing widget and all of its children (recursively down
  85.        the widget tree).  To recreate the windows at a later
  86.        time, call _X_t_R_e_a_l_i_z_e_W_i_d_g_e_t again.  If the widget was man-
  87.        aged, it will be unmanaged automatically before its window
  88.        is freed.
  89.  
  90. SSEEEE AALLSSOO
  91.        XtManageChildren(3Xt)
  92.        _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
  93.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.