NAME

XtAppCreateShell, XtVaAppCreateShell - create top-level widget instance

SYNTAX

Widget XtAppCreateShell(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); Widget XtVaAppCreateShell(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, ...);

ARGUMENTS

_a_p_p_l_i_c_a_t_i_o_n___n_a_m_e Specifies the name of the application instance.
_a_p_p_l_i_c_a_t_i_o_n___c_l_a_s_s Specifies the class name of this application, which usually is the generic name for all instances of this application.
_w_i_d_g_e_t___c_l_a_s_s Specifies the widget class that the application top-level widget should be.
_d_i_s_p_l_a_y Specifies the display from which to get the resources.
_a_r_g_s Specifies the argument list from which to get the resources.
_n_u_m___a_r_g_s Specifies the number of arguments in the argument list.
_._._. Specifies the variable argument list from which to get the resources.

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 property 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