


XtRealizeWidget(3Xt)					 XtRealizeWidget(3Xt)
X11R5									X11R5



NAME
  XtRealizeWidget, XtIsRealized, XtUnrealizeWidget - realize and unrealize
  widgets

SYNTAX
  void XtRealizeWidget(_w)
	Widget _w;

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

  void XtUnrealizeWidget(_w)
	Widget _w;

ARGUMENTS

  _w	    Specifies the widget.

DESCRIPTION
  If the widget	is already realized, _X_t_R_e_a_l_i_z_e_W_i_d_g_e_t simply returns. Other-
  wise,	it performs the	following:

  oo++    Binds all action	names in the widget's translation table	to procedures
       (see Section 10.1.2).

  oo++    Makes a post-order traversal of the widget tree rooted at the speci-
       fied widget and calls the change_managed	procedure of each composite
       widget that has one or more managed children.

  o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 in with informa-
       tion derived from the _C_o_r_e widget fields	and calls the realize pro-
       cedure for the widget, which adds any widget-specific attributes	and
       creates the X window.

  oo++    If the widget is	not a subclass of _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; otherwise, it	continues and performs the following:

       --    Descends recursively to each of the	widget's managed children and
	    calls the realize procedures.  Primitive widgets that instantiate
	    children are responsible for realizing those children themselves.

       --    Maps all of	the managed children windows that have
	    mapped_when_managed	_T_r_u_e.  (If a widget is managed but
	    mapped_when_managed	is _F_a_l_s_e, the widget is	allocated visual
	    space but is not displayed.	 Some people seem to like this to
	    indicate certain states.)

  If the widget	is a top-level shell widget (that is, it has no	parent), and
  mapped_when_managed is _T_r_u_e, _X_t_R_e_a_l_i_z_e_W_i_d_g_e_t maps the	widget window.

  The _X_t_I_s_R_e_a_l_i_z_e_d function returns _T_r_u_e if the	widget has been	realized,
  that is, if the widget has a nonzero X window	ID.

  Some widget procedures (for example, set_values) might wish to operate dif-
  ferently after the widget has	been realized.

  The _X_t_U_n_r_e_a_l_i_z_e_W_i_d_g_e_t	function destroys the windows of an existing widget
  and all of its children (recursively down the	widget tree).  To recreate
  the windows at a later time, call _X_t_R_e_a_l_i_z_e_W_i_d_g_e_t again.  If the widget was
  managed, it will be unmanaged	automatically before its window	is freed.

SEE ALSO
  XtManageChildren(3Xt)
  _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



























































