


XtAppCreateShell(3Xt)					XtAppCreateShell(3Xt)
X11R5									X11R5



NAME
  XtAppCreateShell - create top-level widget instance

SYNTAX
  Widget XtAppCreateShell(_a_p_p_l_i_c_a_t_i_o_n__n_a_m_e, _a_p_p_l_i_c_a_t_i_o_n__c_l_a_s_s, _w_i_d_g_e_t__c_l_a_s_s,
  _d_i_s_p_l_a_y,
			  _a_r_g_s,	_n_u_m__a_r_g_s)
	String _a_p_p_l_i_c_a_t_i_o_n__n_a_m_e;
	String _a_p_p_l_i_c_a_t_i_o_n__c_l_a_s_s;
	WidgetClass _w_i_d_g_e_t__c_l_a_s_s;
	Display	*_d_i_s_p_l_a_y;
	ArgList	_a_r_g_s;
	Cardinal _n_u_m__a_r_g_s;

ARGUMENTS

  _a_p_p_l_i_c_a_t_i_o_n__c_l_a_s_s
	    Specifies the class	name of	this application.

  _a_p_p_l_i_c_a_t_i_o_n__n_a_m_e
	    Specifies the name of the application instance.

  _a_r_g_s	    Specifies the argument list	in which to set	in the WM_COMMAND
	    property.

  _d_i_s_p_l_a_y   Specifies the display from which to	get the	resources.

  _n_u_m__a_r_g_s  Specifies the number of arguments in the argument list.

  _w_i_d_g_e_t__c_l_a_s_s
	    Specifies the widget class that the	application top-level widget
	    should be.

DESCRIPTION
  The _X_t_A_p_p_C_r_e_a_t_e_S_h_e_l_l function	saves the specified application	name and
  application class for	qualifying all widget resource specifiers.  The
  application name and application class are used as the left-most components
  in all widget	resource names for this	application.  _X_t_A_p_p_C_r_e_a_t_e_S_h_e_l_l should
  be used to create a new logical application within a program or to create a
  shell	on another display.  In	the first case,	it allows the specification
  of a new root	in the resource	hierarchy.  In the second case,	it uses	the
  resource database associated with the	other display.

  Note that the	widget returned	by _X_t_A_p_p_C_r_e_a_t_e_S_h_e_l_l has	the WM_COMMAND pro-
  perty	set for	session	managers (see Chapter 4).

SEE ALSO
  XtCreateWidget(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








