NAME
XtCreatePopupShell, XtVaCreatePopupShell - create a popup shell
SYNTAX
Widget XtCreatePopupShell(String _n_a_m_e, WidgetClass _w_i_d_g_e_t___c_l_a_s_s,
Widget _p_a_r_e_n_t, ArgList _a_r_g_s, Cardinal _n_u_m___a_r_g_s);
Widget XtVaCreatePopupShell(String _n_a_m_e, WidgetClass _w_i_d_g_e_t___c_l_a_s_s,
Widget _p_a_r_e_n_t, ...);
ARGUMENTS
-
_a_r_g_s
Specifies the argument list to override the resource defaults.
-
-
_n_a_m_e
Specifies the text name for the created shell widget.
-
-
_n_u_m___a_r_g_s
Specifies the number of arguments in the argument list.
-
-
_p_a_r_e_n_t
Specifies the parent widget.
-
-
_w_i_d_g_e_t___c_l_a_s_s
Specifies the widget class pointer for the created shell widget.
-
-
_._._.
Specifies the variable argument list to override the resource defaults.
-
DESCRIPTION
The
_X_t_C_r_e_a_t_e_P_o_p_u_p_S_h_e_l_l
function ensures that the specified class is a subclass of
_S_h_e_l_l
and, rather than using insert_child to attach the widget to the parent's
children list, attaches the shell to the parent's pop-ups list directly.
A spring-loaded pop-up invoked from a translation table already must exist
at the time that the translation is invoked,
so the translation manager can find the shell by name.
Pop-ups invoked in other ways can be created ``on-the-fly'' when
the pop-up actually is needed.
This delayed creation of the shell is particularly useful when you pop up
an unspecified number of pop-ups.
You can look to see if an appropriate unused shell (that is, not
currently popped up) exists and create a new shell if needed.
SEE ALSO
XtCreateWidget(3Xt),
XtPopdown(3Xt),
XtPopup(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