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

FreeBSD Manual Pages

  
 
  

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

NAME
       XmtBuildToplevel(),  XmtBuildQueryToplevel()  -	create a TopLevelShell
       widget and all of its descendants.

SYNOPSIS
       #include	<Xmt/Create.h>

       Widget XmtBuildToplevel(Widget parent, String name)

       Widget XmtBuildQueryToplevel(Widget parent, String name,
		      {	String child_name, Widget *child_address, }
		      NULL)

ARGUMENTS
       INPUTS

	    parent The parent of the shell to be created.

	    name   The name of the shell to be created.

	    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 TopLevelShell widget.

DESCRIPTION
       XmtBuildToplevel()  and	XmtBuildQueryToplevel()	 call	XtCreatePopup-
       Shell()	to  create a TopLevelShell with	the specified parent and name.
       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 XmtCreateChildren()	and XmtCreateQueryChildren() do.

       Like XmtCreateQueryChildren(), XmtBuildQueryToplevel() can return  some
       of  the	widgets	 it  creates. If any of	the created widgets has	a name
       that appears as a child_name argument, then that	widget is returned  in
       the  corresponding  child_address argument in the variable-length argu-
       ment list.

USAGE
       The TopLevelShell widget	is useful for ``auxiliary''  windows  of  your
       application.  These windows are unlike dialog boxes in that they	can be
       iconified independently of the application  itself.  Note  that	unlike
       Motif  dialogs implemented with the XmDialogShell widget, TopLevelShell
       widgets must be popped up and down with XtPopup() and XtPopdown().

       Use XmtBuildDialog() to create dialog boxes in a	similar	way.

SEE ALSO
       Chapter 11, Automatic Widget Creation,
       XmtBuildApplication(), XmtBuildDialog(),	XmtCreateChildren(),
       XmtCreateQueryChildren(), XtCreatePopupShell(), XtPopdown(), XtPopup().

Xmt				  Motif	Tools		   XmtBuildToplevel(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=XmtBuildToplevel&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help