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