1MrmRegisterNames(library call)                  MrmRegisterNames(library call)
2
3
4

NAME

6       MrmRegisterNames  — Registers the values associated with the names ref‐
7       erenced in UIL (for example, UIL callback function names or UIL identi‐
8       fier names)
9

SYNOPSIS

11       #include <Mrm/MrmPublic.h>
12       Cardinal MrmRegisterNames(
13       MrmRegisterArglist register_list,
14       MrmCount register_count);
15

DESCRIPTION

17       The  MrmRegisterNames  function registers a vector of names and associ‐
18       ated values for access in MRM.  The values can be  callback  functions,
19       pointers  to  user-defined  data, or any other values.  The information
20       provided is used to resolve symbolic references occurring in UID  files
21       to their run-time values.  For callbacks, this information provides the
22       procedure address required by the Motif Toolkit.   For  names  used  as
23       identifiers  in UIL, this information provides any run-time mapping the
24       application needs.
25
26       This function is similar to  MrmRegisterNamesInHierarchy,  except  that
27       the  scope  of  the  names registered by MrmRegisterNamesInHierarchy is
28       limited to the hierarchy  specified  in  the  call  to  that  function,
29       whereas  the  names  registered  by MrmRegisterNames have global scope.
30       When MRM looks up a name, it first tries to find the name  among  those
31       registered  for the given hierarchy.  If that lookup fails, it tries to
32       find the name among those registered globally.
33
34       register_list
35                 Specifies a list of name/value pairs for the names to be reg‐
36                 istered.   Each  name  is  a  case-sensitive, NULL-terminated
37                 ASCII string.  Each value is a 32-bit  quantity,  interpreted
38                 as  a  procedure  address if the name is a callback function,
39                 and uninterpreted otherwise.
40
41       register_count
42                 Specifies the number of entries in register_list.
43
44       The names in the list are  case-sensitive.   The  list  can  be  either
45       ordered or unordered.
46
47       Callback  functions  registered  through MrmRegisterNames can be either
48       regular or creation callbacks.   Regular  callbacks  have  declarations
49       determined  by Motif Toolkit and user requirements.  Creation callbacks
50       have the same format as any other callback:
51
52       void CallBackProc(
53       Widget *widget_id,
54       Opaque tag,
55       XmAnyCallbackStruct *callback_data);
56
57       widget_id Specifies the widget ID associated with the widget performing
58                 the callback (as in any callback function).
59
60       tag       Specifies the tag value (as in any callback function).
61
62       callback_data
63                 Specifies a widget-specific data structure.  This data struc‐
64                 ture has a minimum of two members:  event  and  reason.   The
65                 reason member is always set to MrmCR_CREATE.
66
67       Note  that  the  widget  name  and parent are available from the widget
68       record accessible through widget_id.
69

RETURN

71       This function returns one of the following status return constants:
72
73       MrmSUCCESS
74                 The function executed successfully.
75
76       MrmFAILURE
77                 The function failed.
78
79
80
81                                                MrmRegisterNames(library call)
Impressum