Volume 6A: Motif Programming Manual

Cardinal

MrmRegisterNames(identifier_list, num_identifiers)

MrmRegisterArglist identifier_list;

MrmCount num_identifiers;

Cardinal

MrmRegisterNamesInHierarchy(hierarchy, identifier_list,

num_identifiers)

MrmHierarchy hierarchy;

MrmRegisterArglist identifier_list;

MrmCount num_identifiers;

A call to MrmRegisterNames() makes the identifiers accessible from any open Mrm hierarchy, while a call to

MrmRegisterNamesInHierarchy() makes the identifiers accessible from the Mrm hierarchy passed to the

function. Identifiers that are registered in a specific Mrm hierarchy take precedence over those that are registered

globally. The identifier_list argument specifies an array of MrmRegisterArg structures, and

num_identifiers indicates the size of the array. The MrmRegisterArg structure indicates the mapping from

an identifier name to an application value and is defined as follows:

typedef struct {

String name;

XtPointer value;

} MrmRegisterArg, *MrmRegisterArglist;

The name field is the name of the identifier as used in the UIL module. The name is case−sensitive, unless it is being

referenced from a module that has the names option set to case_insensitive, in which case the name must be

upper case. The value field is a pointer to an application variable. Since value is an XtPointer, you should only

register values that are pointers. If you use a value whose size is not the same as an XtPointer, part of the value

may be lost or corrupted. The size of certain C values, such as int and float, are not ...