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
       display

SYNTAX
       Widget XtOpenApplication(XtAppContext *app_context_return, String ap-
	      plication_class, XrmOptionDescRec	*options, Cardinal num_op-
	      tions, int *argc_in_out, String *argv_in_out, String *fall-
	      back_resources, WidgetClass widget_class,	ArgList	args, Cardinal
	      num_args);

       Widget XtVaOpenApplication(XtAppContext *app_context_return, String ap-
	      plication_class, XrmOptionDescRec	*options, Cardinal num_op-
	      tions, int *argc_in_out, String *argv_in_out, String *fall-
	      back_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-
		 specific resources.  The options argument is passed as	a pa-
		 rameter to XrmParseCommand.  For further information, see
		 Xlib -	C Language 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
		 resource 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
		 specification 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
		 resource specification	for the	created	shell widget.

DESCRIPTION
       The XtOpenApplication function calls XtToolkitInitialize	followed by
       XtCreateApplicationContext, then	calls XtOpenDisplay with dis-
       play_string NULL	and application_name NULL, and finally calls XtAppCre-
       ateShell	with application_name NULL, the	specified widget_class,	and
       the specified args and num_args and returns the created shell. The mod-
       ified 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
       XtOpenApplication terminates the	application. If	fallback_resources is
       non-NULL, XtAppSetFallbackResources is called with the value prior to
       calling XtOpenDisplay.

       XtAppInitialize and XtVaAppInitialize have been superceded 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.1.5		  XtOpenApplication(3)

NAME | SYNTAX | ARGUMENTS | DESCRIPTION | SEE ALSO

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

home | help