


XtCreatePopupShell(3Xt)				      XtCreatePopupShell(3Xt)
X11R5									X11R5



NAME
  XtCreatePopupShell - create a	popup shell

SYNTAX
  Widget XtCreatePopupShell(_n_a_m_e, _w_i_d_g_e_t__c_l_a_s_s,	_p_a_r_e_n_t,	_a_r_g_s, _n_u_m__a_r_g_s)
	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;

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.

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	sub-
  class	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
















