MrmFetchWidgetOverride - Man Page

#include <Mrm/MrmPublic​.h>
Cardinal MrmFetchWidgetOverride(
MrmHierarchy hierarchy_id,
const char *index,
Widget parent_widget,
const char *override_name,
ArgList override_args,
Cardinal override_num_args,
Widget *widget,
MrmType *class);

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 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​.

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 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​.

class

Returns the class code identifying MRM​'s widget class​. Literals identifying MRM widget class codes are defined in the include file Mrm/MrmPublic​.h​.

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​.

MrmOpenHierarchyPerDisplay(3), MrmFetchWidget(3)​.

MrmFetchWidget(3).