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

FreeBSD Manual Pages

  
 
  

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

NAME
       XmtBuildDialog(), XmtBuildQueryDialog() - create	a dialog shell and its
       descendants.

SYNOPSIS
       #include	<Xmt/Create.h>

       Widget XmtBuildDialog(Widget parent, String dialog_name,	XtResourceList
		      resources, Cardinal num_resources)

       Widget XmtBuildQueryDialog(Widget parent, String	dialog_name,
		      XtResourceList resources,	Cardinal num_resources,
		      {	String child_name, Widget *child_address, }
		      NULL)

ARGUMENTS
       INPUTS

	    parent The parent of the dialog shell to be	created.

	    dialog_name
		   The name of the dialog shell	to be created.

	    resources
		   An optional resource	list that gives	names, types and  off-
		   sets	 for  each of the data items that will be displayed or
		   input through the dialog box.

	    num_resources
		   The number of elements in the resources array.

	    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	child of the newly created dialog shell; a grandchild of  par-
	    ent.

DESCRIPTION
       XmtBuildDialog()	and XmtBuildQueryDialog() create an XmDialogShell wid-
       get with	the specified name and parent, and then	read  the  xmtChildren
       resource	 for that widget database and use it to	recursively create all
       the descendants of the dialog shell, in the same	 way  that  XmtCreate-
       Children() and

       XmtCreateQueryChildren()	do.

       Like XmtCreateQueryChildren(), XmtBuildQueryDialog() will return	point-
       ers to the widgets named	in its NULL-terminated	variable-length	 argu-
       ment list.

       XmtCreateChildren()  and	 related  widget  creation  functions  parse a
       widget specification grammar described in Chapter 12, Automatic	Widget
       Creation.  XmtBuildDialog() and XmtBuildQueryDialog() extend this gram-
       mar, to allow the name of a data	value to be associated with any	widget
       in the dialog.  The resources argument is an array of XtResource	struc-
       tures that defines a data type, size, and  offset  for  each  of	 these
       named  data  values.  These named data values are used by the Xmt auto-
       matic dialog management facilities  described  in  Chapter  31,	Custom
       Dialogs and Automatic Dialog Management.

USAGE
       Note  that  these functions do not return the XmDialogShell widget they
       create, but rather the child of that widget.  (Recall that  shell  wid-
       gets  can  only	have a single child.)  You can pop up and pop down the
       dialog shell by managing	and unmanaging its child. If you are using the
       automatic  dialog management facilities of Chapter 29, you can also use
       convenience functions like XmtDialogDo()	and XmtDialogDoSync().

SEE ALSO
       Chapter 11, Automatic Widget Creation,
       Chapter 29, Custom Dialogs and Automatic	Dialog Management,
       XmtBuildToplevel(), XmtCreateChildren(),	XmtDialogDo().

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

home | help