home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xtismanaged.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  10.1 KB  |  265 lines
  1.  
  2.  
  3.  
  4. XtManageChildren(3Xt)       XT FUNCTIONS        XtManageChildren(3Xt)
  5.  
  6.  
  7. NNAAMMEE
  8.        XtManageChildren, XtManageChild, XtUnmanageChildren,
  9.        XtUnmanageChild, XtChangeManagedSet, XtIsManaged - manage
  10.        and unmanage children
  11.  
  12. SSYYNNTTAAXX
  13.        typedef Widget *WidgetList;
  14.  
  15.        void XtManageChildren(_c_h_i_l_d_r_e_n, _n_u_m___c_h_i_l_d_r_e_n)
  16.          WidgetList _c_h_i_l_d_r_e_n;
  17.          Cardinal _n_u_m___c_h_i_l_d_r_e_n;
  18.  
  19.        void XtManageChild(_c_h_i_l_d)
  20.          Widget _c_h_i_l_d;
  21.  
  22.        void XtUnmanageChildren(_c_h_i_l_d_r_e_n, _n_u_m___c_h_i_l_d_r_e_n)
  23.          WidgetList _c_h_i_l_d_r_e_n;
  24.          Cardinal _n_u_m___c_h_i_l_d_r_e_n;
  25.  
  26.        void XtUnmanageChild(_c_h_i_l_d)
  27.          Widget _c_h_i_l_d;
  28.  
  29.        void XtChangeManagedSet(_u_n_m_a_n_a_g_e___c_h_i_l_d_r_e_n,
  30.        _n_u_m___u_n_m_a_n_a_g_e___c_h_i_l_d_r_e_n, _m_a_n_a_g_e___c_h_i_l_d_r_e_n,
  31.        _n_u_m___m_a_n_a_g_e___c_h_i_l_d_r_e_n, _p_o_s_t___u_n_m_a_n_a_g_e___p_r_e___m_a_n_a_g_e___h_o_o_k,
  32.        _c_l_i_e_n_t___d_a_t_a)
  33.          WidgetList _u_n_m_a_n_a_g_e___c_h_i_l_d_r_e_n;
  34.          Cardinal _n_u_m___u_n_m_a_n_a_g_e___c_h_i_l_d_r_e_n;
  35.          WidgetList _m_a_n_a_g_e___c_h_i_l_d_r_e_n;
  36.          Cardinal _n_u_m___m_a_n_a_g_e___c_h_i_l_d_r_e_n;
  37.          XtCSMProc _p_o_s_t___u_n_m_a_n_a_g_e___p_r_e___m_a_n_a_g_e___h_o_o_k;
  38.          XtPointer _c_l_i_e_n_t___d_a_t_a;
  39.  
  40.        Boolean XtIsManaged(_w_i_d_g_e_t)
  41.          Widget _w_i_d_g_e_t
  42.  
  43. AARRGGUUMMEENNTTSS
  44.        _c_h_i_l_d     Specifies the child.
  45.  
  46.        _c_h_i_l_d_r_e_n     Specifies a list of child widgets.
  47.  
  48.        _n_u_m___c_h_i_l_d_r_e_n
  49.          Specifies the number of children.
  50.  
  51.        _w_i_d_g_e_t     Specifies the widget.
  52.  
  53.        _m_a_n_a_g_e___c_h_i_l_d_r_e_n
  54.          Specifies the list of widget children to add to
  55.          the managed set.
  56.  
  57.        _n_u_m___m_a_n_a_g_e___c_h_i_l_d_r_e_n
  58.          Specifies the number of entries in the man-
  59.          age_children list.
  60.  
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XtManageChildren(3Xt)       XT FUNCTIONS        XtManageChildren(3Xt)
  71.  
  72.  
  73.        _u_n_m_a_n_a_g_e___c_h_i_l_d_r_e_n
  74.          Specifies the list of widget children to remove
  75.          from the managed set.
  76.  
  77.        _n_u_m___u_n_m_a_n_a_g_e___c_h_i_l_d_r_e_n
  78.          Specifies the number of entries in the unman-
  79.          age_children list.
  80.  
  81.        _p_o_s_t___u_n_m_a_n_a_g_e___p_r_e___m_a_n_a_g_e___h_o_o_k
  82.          Specifies the post unmanage, pre manage hook
  83.          procedure to invoke.
  84.  
  85.        _c_l_i_e_n_t___d_a_t_a
  86.          Specifies the client data to be passed to the
  87.          hook precedure.
  88.  
  89. DDEESSCCRRIIPPTTIIOONN
  90.        The _X_t_M_a_n_a_g_e_C_h_i_l_d_r_e_n function performs the following:
  91.  
  92.        +o    Issues an error if the children do not all have the
  93.         same parent or if the parent is not a subclass of
  94.         _c_o_m_p_o_s_i_t_e_W_i_d_g_e_t_C_l_a_s_s.
  95.  
  96.        +o    Returns immediately if the common parent is being
  97.         destroyed; otherwise, for each unique child on the
  98.         list, _X_t_M_a_n_a_g_e_C_h_i_l_d_r_e_n ignores the child if it
  99.         already is managed or is being destroyed and marks it
  100.         if not.
  101.  
  102.        +o    If the parent is realized and after all children have
  103.         been marked, it makes some of the newly managed chil-
  104.         dren viewable:
  105.  
  106.         -     Calls the change_managed routine of the widgets'
  107.          parent.
  108.  
  109.         -     Calls _X_t_R_e_a_l_i_z_e_W_i_d_g_e_t on each previously unman-
  110.          aged child that is unrealized.
  111.  
  112.         -     Maps each previously unmanaged child that has
  113.          map_when_managed _T_r_u_e.
  114.  
  115.        Managing children is independent of the ordering of chil-
  116.        dren and independent of creating and deleting children.
  117.        The layout routine of the parent should consider children
  118.        whose managed field is _T_r_u_e and should ignore all other
  119.        children.  Note that some composite widgets, especially
  120.        fixed boxes, call _X_t_M_a_n_a_g_e_C_h_i_l_d from their insert_child
  121.        procedure.
  122.  
  123.        If the parent widget is realized, its change_managed pro-
  124.        cedure is called to notify it that its set of managed
  125.        children has changed.  The parent can reposition and
  126.        resize any of its children.  It moves each child as needed
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XtManageChildren(3Xt)       XT FUNCTIONS        XtManageChildren(3Xt)
  137.  
  138.  
  139.        by calling _X_t_M_o_v_e_W_i_d_g_e_t, which first updates the x and y
  140.        fields and then calls _X_M_o_v_e_W_i_n_d_o_w if the widget is real-
  141.        ized.
  142.  
  143.        The _X_t_M_a_n_a_g_e_C_h_i_l_d function constructs a _W_i_d_g_e_t_L_i_s_t of
  144.        length one and calls _X_t_M_a_n_a_g_e_C_h_i_l_d_r_e_n.
  145.  
  146.        The _X_t_U_n_m_a_n_a_g_e_C_h_i_l_d_r_e_n function performs the following:
  147.  
  148.        +o    Issues an error if the children do not all have the
  149.         same parent or if the parent is not a subclass of
  150.         _c_o_m_p_o_s_i_t_e_W_i_d_g_e_t_C_l_a_s_s.
  151.  
  152.        +o    Returns immediately if the common parent is being
  153.         destroyed; otherwise, for each unique child on the
  154.         list, _X_t_U_n_m_a_n_a_g_e_C_h_i_l_d_r_e_n performs the following:
  155.  
  156.         -     Ignores the child if it already is unmanaged or
  157.          is being destroyed and marks it if not.
  158.  
  159.         -     If the child is realized, it makes it nonvisible
  160.          by unmapping it.
  161.  
  162.        +o    Calls the change_managed routine of the widgets' par-
  163.         ent after all children have been marked if the parent
  164.         is realized.
  165.  
  166.        _X_t_U_n_m_a_n_a_g_e_C_h_i_l_d_r_e_n does not destroy the children widgets.
  167.        Removing widgets from a parent's managed set is often a
  168.        temporary banishment, and, some time later, you may manage
  169.        the children again.
  170.  
  171.        The _X_t_U_n_m_a_n_a_g_e_C_h_i_l_d function constructs a widget list of
  172.        length one and calls _X_t_U_n_m_a_n_a_g_e_C_h_i_l_d_r_e_n.
  173.  
  174.        The _X_t_C_h_a_n_g_e_M_a_n_a_g_e_d_S_e_t function performs the following:
  175.  
  176.        +o    Issues an error if the widgets specified in the _m_a_n_-
  177.         _a_g_e___c_h_i_l_d_r_e_n and the _u_n_m_a_n_a_g_e___c_h_i_l_d_r_e_n lists to no
  178.         all have the same parent, or if that parent is not a
  179.         subclass of compositeWidgetClass.
  180.  
  181.        +o    Returns immediately if the common parent is being
  182.         destroyed.
  183.  
  184.        +o    If no _C_o_m_p_o_s_i_t_e_C_l_a_s_s_E_x_t_e_n_s_i_o_n is defined, or a _C_o_m_-
  185.         _p_o_s_i_t_e_C_l_a_s_s_E_x_t_e_n_s_i_o_n is defined but with an
  186.         _a_l_l_o_w_s___c_h_a_n_g_e___m_a_n_a_g_e_d___s_e_t field with a value of
  187.         _F_a_l_s_e, and _X_t_C_h_a_n_g_e_M_a_n_a_g_e_d_S_e_t was invoked with a non-
  188.         NULL _p_o_s_t___u_n_m_a_n_a_g_e___p_r_e___m_a_n_a_g_e___h_o_o_k procedure then
  189.         _X_t_C_h_a_n_g_e_M_a_n_a_g_e_d_S_e_t performs the following:
  190.  
  191.         -     Calls _X_t_U_n_m_a_n_a_g_e_C_h_i_l_d_r_e_n (_u_n_m_a_n_a_g_e___c_h_i_l_d_r_e_n,
  192.          _n_u_m___u_n_m_a_n_a_g_e___c_h_i_l_d_r_e_n).
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. XtManageChildren(3Xt)       XT FUNCTIONS        XtManageChildren(3Xt)
  203.  
  204.  
  205.         -     Calls the _p_o_s_t___u_n_m_a_n_a_g_e___p_r_e___m_a_n_a_g_e___h_o_o_k speci-
  206.          fied.
  207.  
  208.         -     Calls _X_t_M_a_n_a_g_e_C_h_i_l_d_r_e_n (_m_a_n_a_g_e___c_h_i_l_d_r_e_n,
  209.          _n_u_m___m_a_n_a_g_e___c_h_i_l_d_r_e_n) and then returns immedi-
  210.          ately.
  211.  
  212.        +o    Otherwise, if a _C_o_m_p_o_s_i_t_e_C_l_a_s_s_E_x_t_e_n_s_i_o_n is defined
  213.         with an _a_l_l_o_w_s___c_h_a_n_g_e___m_a_n_a_g_e_d___s_e_t field with a value
  214.         of _T_r_u_e, or if no _C_o_m_p_o_s_i_t_e_C_l_a_s_s_E_x_t_e_n_s_i_o_n is defined,
  215.         and _X_t_C_h_a_n_g_e_M_a_n_a_g_e_d_S_e_twas
  216.         _p_o_s_t___u_n_m_a_n_a_g_e___p_r_e___m_a_n_a_g_e___h_o_o_k procedure, then the
  217.         following is performed:
  218.  
  219.         -     For each child on the _u_n_m_a_n_a_g_e___c_h_i_l_d_r_e_n list; if
  220.          the child is already unmanaged or is being
  221.          destroyed it is ignored, otherwise it is marked
  222.          as being unmanaged and if it is realized it is
  223.          made nonvisible by being unmapped.
  224.  
  225.         -     If the _p_o_s_t___u_n_m_a_n_a_g_e___p_r_e___m_a_n_a_g_e___h_o_o_k procdedure
  226.          is non-NULL then it is invoked as specified.
  227.  
  228.         -     For each child on the _m_a_n_a_g_e___c_h_i_l_d_r_e_n list; if
  229.          the child is already managed or it is being
  230.          destroyed it is ignored, otherwise it is marked
  231.          as managed
  232.  
  233.        +o    If the parent is realized and after all children have
  234.         been marked, the change_managed method of the parent
  235.         is invoked and subsequently some of the newly managed
  236.         children are made viewable by:
  237.  
  238.         -     Calling _X_t_R_e_a_l_i_z_e_W_i_d_g_e_t on each of the previ-
  239.          ously unmanaged child that is unrealized.
  240.  
  241.         -     Mapping each previously unmanaged child that has
  242.          _m_a_p___w_h_e_n___m_a_n_a_g_e_d _T_r_u_e.
  243.  
  244.        The _X_t_I_s_M_a_n_a_g_e_d function returns _T_r_u_e if the specified
  245.        widget is of class RectObj or any subclass thereof and is
  246.        managed, or _F_a_l_s_e otherwise.
  247.  
  248. SSEEEE AALLSSOO
  249.        XtMapWidget(3Xt), XtRealizeWidget(3Xt)
  250.        _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
  251.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262. X Version 11           Release 6.1                4
  263.  
  264.  
  265.