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