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