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

FreeBSD Manual Pages

  
 
  

home | help 
XmtBuildApplication(3)	    Library Functions Manual	  XmtBuildApplication(3)

NAME
     XmtBuildApplication(),  XmtBuildQueryApplication() - create a root Applica-
     tionShell widget and all of its descendants.

SYNOPSIS
     #include <Xmt/Create.h>

     Widget XmtBuildApplication(String appname, String appclass, Display
		    *display, ArgList args, Cardinal num_args)

     Widget XmtBuildQueryApplication(String appname, String appclass, Display
		    *display, ArgList args, Cardinal num_args,
		    { String child_name, Widget *child_address, }
		    NULL)

ARGUMENTS
     INPUTS

	  appnameThe name of the root application shell to be created.

	  appclass
		 The resource class name of the root  application  shell  to  be
		 created.

	  displayThe X Display on which the application shell is to be created.

	  args	 An  array  of	name/value  pairs  of resources to be set on the
		 newly created application shell.

	  num_args
		 The number of elements in args.

	  child_name
		 The name of a widget to be returned. May be repeated any number
		 of times in a NULL-terminated variable-length argument list.
     OUTPUTS

     child_address
	  The address at which the widget  specified  by  child_name  is  to  be
	  stored. May be repeated any number of times in a NULL-terminated vari-
	  able length argument list.
     RETURNS

	  The newly created root ApplicationShell widget.

DESCRIPTION
     XmtBuildApplication() and XmtBuildQueryApplication() create a root Applica-
     tionShell	widget	by  calling XtAppCreateShell(), with their appname, app-
     class, display, args and num_args arguments. Then they read the xmtChildren
     resource of the newly created shell and recursively create all the  descen-
     dants of the shell, in the same way that XmtCreateChildren() and XmtCreate-
     QueryChildren()  do.  Like  XmtCreateQueryChildren(), XmtBuildQueryApplica-
     tion() can return pointers to some of the widgets it creates.

USAGE
     Most applications will only have a single root  Application  Shell  widget,
     created by their call to XtAppInitialize() or XmtInitialize(). Applications
     that  do  create  additional root widgets may use these functions to create
     those shells and their descendants.

     Use XmtBuildToplevel() and XmtBuildDialog() to create Top	LevelShell  wid-
     gets and dialog boxes in a similar way.

SEE ALSO
     Chapter 11, Automatic Widget Creation,
     XmtBuildDialog(), XmtBuildToplevel(), XmtCreateChildren(),
     XmtCreateQueryChildren(), XmtInitialize(), XtAppCreateShell(),
     XtAppInitialize().

Xmt				   Motif Tools		  XmtBuildApplication(3)

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

home | help