NAME
XtOpenApplication, XtVaOpenApplication - initialize, open, or close a display
SYNTAX
Widget XtOpenApplication(XtAppContext *_a_p_p___c_o_n_t_e_x_t___r_e_t_u_r_n, String
_a_p_p_l_i_c_a_t_i_o_n___c_l_a_s_s, XrmOptionDescRec *_o_p_t_i_o_n_s, Cardinal
_n_u_m___o_p_t_i_o_n_s, int *_a_r_g_c___i_n___o_u_t, String *_a_r_g_v___i_n___o_u_t, String
*_f_a_l_l_b_a_c_k___r_e_s_o_u_r_c_e_s, WidgetClass _w_i_d_g_e_t___c_l_a_s_s, ArgList _a_r_g_s,
Cardinal _n_u_m___a_r_g_s);
Widget XtVaOpenApplication(XtAppContext *_a_p_p___c_o_n_t_e_x_t___r_e_t_u_r_n, String
_a_p_p_l_i_c_a_t_i_o_n___c_l_a_s_s, XrmOptionDescRec *_o_p_t_i_o_n_s, Cardinal
_n_u_m___o_p_t_i_o_n_s, int *_a_r_g_c___i_n___o_u_t, String *_a_r_g_v___i_n___o_u_t, String
*_f_a_l_l_b_a_c_k___r_e_s_o_u_r_c_e_s, WidgetClass _w_i_d_g_e_t___c_l_a_s_s, ...);
ARGUMENTS
-
_a_p_p___c_o_n_t_e_x_t___r_e_t_u_r_n
Specifies the application context.
-
-
_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.
-
-
_o_p_t_i_o_n_s
Specifies how to parse the command line for any application-specific resources.
-
The options argument is passed as a parameter to
_X_r_m_P_a_r_s_e_C_o_m_m_a_n_d.
For further information,
see _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e.
-
_n_u_m___o_p_t_i_o_n_s
Specifies the number of entries in the options list.
-
-
_a_r_g_c___i_n___o_u_t
Specifies a pointer to the number of command line parameters.
-
-
_a_r_g_v___i_n___o_u_t
Specifies the command line parameters.
-
-
_f_a_l_l_b_a_c_k___r_e_s_o_u_r_c_e_s
Specifies resource values to be used if the application class resource
-
file cannot be opened or read, or NULL.
-
_w_i_d_g_e_t___c_l_a_s_s
Specifies the widget class of the shell to be created.
-
-
_a_r_g_s
Specifies the argument list to override any other resource specification
-
for the created shell widget.
-
_n_u_m___a_r_g_s
Specifies the number of entries in the argument list.
-
-
_._._.
Specifies the variable argument list to override any other resource
-
specification for the created shell widget.
DESCRIPTION
The
_X_t_O_p_e_n_A_p_p_l_i_c_a_t_i_o_n
function calls
_X_t_T_o_o_l_k_i_t_I_n_i_t_i_a_l_i_z_e
followed by
_X_t_C_r_e_a_t_e_A_p_p_l_i_c_a_t_i_o_n_C_o_n_t_e_x_t,
then calls
_X_t_O_p_e_n_D_i_s_p_l_a_y
with _d_i_s_p_l_a_y___s_t_r_i_n_g NULL and _a_p_p_l_i_c_a_t_i_o_n___n_a_m_e NULL, and
finally calls
_X_t_A_p_p_C_r_e_a_t_e_S_h_e_l_l
with _a_p_p_l_i_c_a_t_i_o_n___n_a_m_e NULL, the specified _w_i_d_g_e_t___c_l_a_s_s,
and the specified _a_r_g_s and _n_u_m___a_r_g_s and returns the
created shell. The modified _a_r_g_c and _a_r_g_v returned by
_X_t_D_i_s_p_l_a_y_I_n_i_t_i_a_l_i_z_e
are returned in _a_r_g_c___i_n___o_u_t and _a_r_g_v___i_n___o_u_t. If
_a_p_p___c_o_n_t_e_x_t___r_e_t_u_r_n is not NULL, the created application context
is also returned. If the display specified by the command line cannot
be opened, an error message is issued and
_X_t_O_p_e_n_A_p_p_l_i_c_a_t_i_o_n
terminates the application. If _f_a_l_l_b_a_c_k___r_e_s_o_u_r_c_e_s is non-NULL,
_X_t_A_p_p_S_e_t_F_a_l_l_b_a_c_k_R_e_s_o_u_r_c_e_s
is called with the value prior to calling
_X_t_O_p_e_n_D_i_s_p_l_a_y.
XtAppInitialize and XtVaAppInitialize have been superceded by
_X_t_O_p_e_n_A_p_p_l_i_c_a_t_i_o_n
and
_X_t_V_a_O_p_e_n_A_p_p_l_i_c_a_t_i_o_n
respectively.
SEE ALSO
XtAppInitialize(3Xt), XtVaAppInitialize(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