MrmFetchWidget(3X)

     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);

     VERSION
          This page documents Motif 2.1.

     DESCRIPTION
          The MrmFetchWidgetfunction 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 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 XtManageChildfor 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 previous 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 implementation dependent value.

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