MrmFetchWidgetOverride(Xm) UNIX System V
NAME
MrmFetchWidgetOverride - Fetches any indexed (uil named)
application widget. It overrides the arguments specified for
this application widget in uil.
SYNOPSIS
#include <Xm/Intrinsics>
#include <Mrm/MrmPublic.h>
Cardinal MrmFetchWidgetOverride(hierarchy_id, index,
parent_widget, override_name,
override_args, override_num_args, widget, class)
MrmHierarchy hierarchy_id;
String index;
Widget parent_widget;
String override_name;
ArgList override_args;
Cardinal override_num_args;
Widget *widget;
MrmType *class;
DESCRIPTION
The MrmFetchWidgetOverride function is the extended version
of MrmFetchWidget. It is identical to MrmFetchWidget,
except that it allows the caller to override the widget's
name and any arguments that MrmFetchWidget would otherwise
retrieve from the uid file or one of the defaulting
mechanisms. That is, the override argument list is not
limited to those arguments in the uid file.
The override arguments apply only to the widget fetched and
returned by this function. Its children (subtree) do not
receive any override parameters.
hierarchy_id
Specifies the ID of the uid hierarchy that
contains the interface definition. The
hierarchy_id was returned in a previous call to
MrmOpenHierarchy.
index Specifies the uil name of the widget to fetch.
parent_widget
Specifies the parent widget ID.
override_name
Specifies the name to override the widget name.
Use a NULL value if you do not want to override
the widget name.
override_args
Specifies the override argument list, exactly as
would be given to XtCreateWidget (conversion
complete and so forth). Use a NULL value if you
do not want to override the argument list.
override_num_args
Specifies the number of arguments in
override_args.
widget Returns the widget ID of the created widget. If
this is not NULL when you call
MrmFetchWidgetOverride, MRM assumes that the
widget has already been created and
MrmFetchWidgetOverride returns MrmFAILURE.
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.
RETURN VALUE
This function returns one of these status return constants:
MrmSUCCESS The function executed successfully.
MrmNOTFOUND Widget not found in uid hierarchy.
MrmFAILURE The function failed.
RELATED INFORMATION
MrmFetchWidget(Xm)
(printed 2/14/90) MrmFetchWidgetOverride(Xm)