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

FreeBSD Manual Pages


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

       MrmFetchWidget  --  Fetches and creates an indexed (UIL named) applica-
       tion widget and its children

       #include	<Mrm/MrmPublic.h>
       Cardinal	MrmFetchWidget(
       MrmHierarchy hierarchy_id,
       String index,
       Widget parent_widget,
       Widget *widget,
       MrmType *class);

       The MrmFetchWidget function fetches and creates an indexed  application
       widget  and its children.  The indexed application widget is any	widget
       that is named in	UIL.  In fetch operations, the fetched	widget's  sub-
       tree  is	 also fetched and created.  This widget	must not appear	as the
       child of	a widget within	its own	subtree. MrmFetchWidget	does not  exe-
       cute XtManageChild for the newly	created	widget.

       All  widgets fetched by a call to MrmFetchWidget	are not	managed	at the
       time of their creation callbacks.

		 Specifies the ID of the UID hierarchy that contains  the  in-
		 terface  definition.	The value of hierarchy_id was returned
		 in a previous call to MrmOpenHierarchyPerDisplay.

       index	 Specifies the UIL name	of the widget to fetch.

		 Specifies the parent widget ID.

       widget	 Returns the widget ID of the created widget.

       class	 This argument must be set to an actual	pointer; it cannot  be
		 a  NULL  pointer. MrmFetchWidget sets this argument to	an im-
		 plementation dependent	value.

       An application can fetch	any named widget in the	 UID  hierarchy	 using
       MrmFetchWidget.	 MrmFetchWidget	 can  be called	at any time to fetch a
       widget that was not fetched at application startup.  MrmFetchWidget can
       be  used	 to  defer fetching pop-up widgets until they are first	refer-
       enced (presumably in a callback), and then used to fetch	them once.

       MrmFetchWidget can also create multiple instances of a widget (and  its
       subtree).   In this case, the UID definition functions as a template; a
       widget definition can be	fetched	any number of times.   An  application
       can use this template to	make multiple instances	of a widget, for exam-
       ple, in a dialog	box box	or menu.

       The index (UIL name) that identifies the	widget must be	known  to  the

       This function returns one of the	following status return	constants:

		 The function executed successfully.

		 The hierarchy ID was invalid.

		 The widget was	not found in UID hierarchy.

		 The function failed.

       MrmOpenHierarchyPerDisplay(3), MrmFetchWidgetOverride(3).



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

home | help