MrmFetchWidget(3X) UNIX System V MrmFetchWidget(3X)
NAME
MrmFetchWidget-Fetches and creates any indexed (UIL named)
application widgets and its children
SYNOPSIS
#include <Mrm/MrmPublic.h>
Cardinal MrmFetchWidget(hierarchy_id, index, parent_widget, widget, class)
MrmHierarchyhierarchy_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 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.
hierarchy_idSpecifies the ID of the uid hierarchy that
contains the interface definition. The
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 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.
1 (printed 6/8/92)
MrmFetchWidget(3X) UNIX System V MrmFetchWidget(3X)
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
This function returns one of these status return constants:
MrmSUCCESS The function executed successfully.
MrmBADHIERARCHY The hierarchy ID was invalid.
MrmNOTFOUND The widget was not found in UID
hierarchy.
MrmFAILURE The function failed.
RELATED INFORMATION
MrmOpenHierarchyPerDisplay(3X), MrmFetchWidgetOverride(3X).
2 (printed 6/8/92)