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

FreeBSD Manual Pages

  
 
  

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

NAME
     XtAppInitialize, XtVaAppInitialize - initialize, open, or close a display

SYNTAX
     #include <X11/Intrinsic.h>

     Widget XtAppInitialize(XtAppContext* app_context_return, const char *appli-
	    cation_class,  XrmOptionDescRec*  options, Cardinal num_options, int
	    *argc_in_out, char **argv_in_out,  String  *fallback_resources,  Ar-
	    gList args, Cardinal num_args);

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

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.

     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  XtAppInitialize  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, widget_class applicationShellWidgetClass, and the specified
     args  and	num_args  and  returns the created shell.  The modified argc and
     argv returned  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 XtAppInitialize terminates
     the  application.	 If  fallback_resources is non-NULL, XtAppSetFallbackRe-
     sources is called with the value prior to calling XtOpenDisplay.

     XtAppInitialize and XtVaAppInitialize have been superseded by  XtOpenAppli-
     cation and XtVaOpenApplication respectively.

SEE ALSO
     XtOpenApplication(3), XtVaOpenApplication(3)
     X Toolkit Intrinsics - C Language Interface
     Xlib - C Language X Interface

X Version 11			   libXt 1.3.1		      XtAppInitialize(3)

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

home | help