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 Ap-
       plicationShell 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

	    appname
		   The name of the root	application shell to be	created.

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

	    display
		   The	X Display on which the application shell is to be cre-
		   ated.

	    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	 argu-
		   ment	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
	    variable length argument list.
       RETURNS

	    The	newly created root ApplicationShell widget.

DESCRIPTION
       XmtBuildApplication()  and  XmtBuildQueryApplication()  create  a  root
       ApplicationShell	widget by calling XtAppCreateShell(), with their  app-
       name,  appclass,	 display,  args	and num_args arguments.	Then they read
       the xmtChildren resource	of the newly  created  shell  and  recursively
       create all the descendants of the shell,	in the same way	that XmtCreat-
       eChildren() and XmtCreateQueryChildren()	do.  Like  XmtCreateQueryChil-
       dren(),	XmtBuildQueryApplication()  can	return pointers	to some	of the
       widgets it creates.

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

       Use  XmtBuildToplevel()	and  XmtBuildDialog() to create	Top LevelShell
       widgets 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)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | USAGE | SEE ALSO

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

home | help