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

FreeBSD Manual Pages


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

       XmtCreateChild(),  XmtCreateQueryChild(),  XmtCreateQueryListChild()  -
       create a	named child and	all of its descendants.

       Widget XmtCreateChild(Widget parent, String name)

       Widget XmtCreateQueryChild(Widget parent, String	name,
		      {	String child_name, Widget *child_address, }

       Widget XmtCreateQueryListChild(Widget parent, XmtWidgetList * names,
		      Cardinal num_names)

       typedef struct {
		      XrmQuark nameq;
		      Widget *widgetp;
       } XmtWidgetList;


	    parent The widget that is to have a	named child created.

	    name   The name of the child to be created.

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

	    names  An array containing num_names entries.

		   The number of entries in the	namesP lilst.


		   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.


	    The	newly created child of parent.

       XmtCreateChild(),  XmtCreateQueryChild(), and XmtCreateQueryListChild()
       are  similar  to	 XmtCreateChildren(),	XmtCreateQueryChildren()   and
       XmtCreateQueryListChildren().  While  the  latter  functions  read  the
       xmtChildren resource of a widget	and create all of its children,	 these
       functions  create only a	single child of	the parent widget. The name of
       this child is specified by name,	and its	type is	determined by  reading
       its  xmtType  resource,	which must specify a registered	widget type or
       template, as described in Chapter 11, Automatic Widget Creation.

       Once the	functions have created this first named	child, they  read  the
       child's	xmtChildren resource, and proceed to create all	of its descen-
       dants just as the XmtCreateChildren() family of functions do. Once  all
       descendants  have  been	created,  these	 functions return the original
       child widget.

       Like XmtCreateQueryChildren(),  XmtCreateQueryChild()  can  return  the
       widgets	it  creates  in	the child_address arguments in its NULL-termi-
       nated variable-length argument list.

       Also like XmtCreateQueryListChildren(),	XmtCreateQueryListChild()  can
       return  the widgets it creates via the names array argument. Each entry
       in this array has two values: a XrmQuark	nameq and a Widget *  widgetp.
       The  nameq  must	 be initialized	to the Quark corresponding to the wid-
       get's name (typically by	calling	XrmQuarkToString); the widgetp must be
       initialized  to	point  to a Widget variable. The address pointed to by
       widgetp will be set to the address of the last widget created with  the
       given name, or NULL if no such widget was created.

       These functions are useful when you want	to defer creation of some sub-
       tree of your widget hierarchy. XmtBuildDialog() and  XmtBuildToplevel()
       are also	useful for this	purpose.

       Chapter 11, Automatic Widget Creation,
       XmtBuild[Query]Application(), XmtBuild[Query]Dialog(),
       XmtBuild[Query]Toplevel(), XmtCreate[Query]Children(),

Xmt				  Motif	Tools		     XmtCreateChild(3)


Want to link to this manual page? Use this URL:

home | help