NAME    [Toc]    [Back]

       MrmFetchWidget  -  Fetches  and  creates  any indexed (UIL
       named) application widgets and its children

SYNOPSIS    [Toc]    [Back]

       #include <Mrm/MrmPublic.h>

       Cardinal MrmFetchWidget(hierarchy_id,  index,  parent_widget,
 widget, class)
               MrmHierarchy hierarchy_id;
               String index;
               Widget parent_widget;
               Widget *widget;
               MrmType *class;

DESCRIPTION    [Toc]    [Back]

       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 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.  Specifies
 the ID of the uid hierarchy that contains the interface
 definition. The hierarchy_id was returned in a previous
 call to MrmOpenHierarchyPerDisplay.  Specifies the UIL
       name  of the widget to fetch.  Specifies the parent widget
       ID.  Returns the widget ID of the created widget.  Returns
       the  class code identifying MRM's widget class. The widget
       class code for the main window  widget,  for  example,  is
       MRMwcMainWindow.  Literals  identifying  MRM  widget class
       codes are defined in <Mrm.h>.

       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  referenced
       (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
       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 VALUE    [Toc]    [Back]

       This function returns one  of  these  status  return  constants:
 The function executed successfully.  The hierarchy
       ID was invalid.  The widget was not found in  UID  hierarchy.
  The function failed.

SEE ALSO    [Toc]    [Back]

       MrmOpenHierarchyPerDisplay(3X), MrmFetchWidgetOverride(3X)



                                               MrmFetchWidget(3X)