Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XtOpenApplication(3)		  XT FUNCTIONS		    XtOpenApplication(3)

NAME
     XtOpenApplication,  XtVaOpenApplication - initialize, open, or close a dis-
     play

SYNTAX
     #include <X11/Intrinsic.h>

     Widget XtOpenApplication(XtAppContext *app_context_return, const char  *ap-
	    plication_class,  XrmOptionDescRec	*options,  Cardinal num_options,
	    int *argc_in_out, char  **argv_in_out,  String  *fallback_resources,
	    WidgetClass widget_class, ArgList args, Cardinal num_args);

     Widget  XtVaOpenApplication(XtAppContext  *app_context_return,  const  char
	    *application_class, XrmOptionDescRec *options, Cardinal num_options,
	    int *argc_in_out, char  **argv_in_out,  String  *fallback_resources,
	    WidgetClass widget_class, ...);

ARGUMENTS
     app_context_return
	       Specifies the application context.

     application_class
	       Specifies  the  class  name of this application, which usually is
	       the generic name for all instances of this application.

     options   Specifies how to parse the command line for any	application-spe-
	       cific  resources.   The options argument is passed as a parameter
	       to XrmParseCommand.  For further information, see Xlib -  C  Lan-
	       guage X Interface.

     num_options
	       Specifies the number of entries in the options list.

     argc_in_out
	       Specifies a pointer to the number of command line parameters.

     argv_in_out
	       Specifies the command line parameters.

     fallback_resources
	       Specifies resource values to be used if the application class re-
	       source file cannot be opened or read, or NULL.

     widget_class
	       Specifies the widget class of the shell to be created.

     args      Specifies the argument list to override any other resource speci-
	       fication for the created shell widget.

     num_args  Specifies the number of entries in the argument list.

     ...       Specifies  the  variable  argument list to override any other re-
	       source specification for the created shell widget.

DESCRIPTION
     The XtOpenApplication function calls XtToolkitInitialize followed by XtCre-
     ateApplicationContext, then calls XtOpenDisplay  with  display_string  NULL
     and application_name NULL, and finally calls XtAppCreateShell with applica-
     tion_name	NULL,  the  specified  widget_class,  and the specified args and
     num_args and returns the created shell.  The modified  argc  and  argv  re-
     turned  by XtDisplayInitialize are returned in argc_in_out and argv_in_out.
     If app_context_return 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 XtOpenApplication  terminates  the	applica-
     tion.   If  fallback_resources  is  non-NULL,  XtAppSetFallbackResources is
     called with the value prior to calling XtOpenDisplay.

     XtAppInitialize and  XtVaAppInitialize  have  been  superseded  by  XtOpen-
     Application and XtVaOpenApplication respectively.

SEE ALSO
     XtAppInitialize(3), XtVaAppInitialize(3)
     X Toolkit Intrinsics - C Language Interface
     Xlib - C Language X Interface

X Version 11			   libXt 1.3.1		    XtOpenApplication(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XtOpenApplication&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help