MrmFetchWidget(library call)											      MrmFetchWidget(library call)

NAME

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

SYNOPSIS

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

DESCRIPTION

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

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

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

       index	 Specifies the UIL name of the widget to fetch.

       parent_widget
		 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  implementa-
		 tion 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  ref-
       erenced (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
       example, in a dialog box box or menu.

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

RETURN

       This function returns one of the following status return constants:

       MrmSUCCESS
		 The function executed successfully.

       MrmBAD_HIERARCHY
		 The hierarchy ID was invalid.

       MrmNOT_FOUND
		 The widget was not found in UID hierarchy.

       MrmFAILURE
		 The function failed.

RELATED

       MrmOpenHierarchyPerDisplay(3), MrmFetchWidgetOverride(3).

														      MrmFetchWidget(library call)