|
Packit |
b099d7 |
'\" t
|
|
Packit |
b099d7 |
...\" RegisteC.sgm /main/8 1996/09/08 21:26:23 rws $
|
|
Packit |
b099d7 |
.de P!
|
|
Packit |
b099d7 |
.fl
|
|
Packit |
b099d7 |
\!!1 setgray
|
|
Packit |
b099d7 |
.fl
|
|
Packit |
b099d7 |
\\&.\"
|
|
Packit |
b099d7 |
.fl
|
|
Packit |
b099d7 |
\!!0 setgray
|
|
Packit |
b099d7 |
.fl \" force out current output buffer
|
|
Packit |
b099d7 |
\!!save /psv exch def currentpoint translate 0 0 moveto
|
|
Packit |
b099d7 |
\!!/showpage{}def
|
|
Packit |
b099d7 |
.fl \" prolog
|
|
Packit |
b099d7 |
.sy sed -e 's/^/!/' \\$1\" bring in postscript file
|
|
Packit |
b099d7 |
\!!psv restore
|
|
Packit |
b099d7 |
.
|
|
Packit |
b099d7 |
.de pF
|
|
Packit |
b099d7 |
.ie ?\\*(f1?? .ds f1 \\n(.f
|
|
Packit |
b099d7 |
.el .ie ?\\*(f2?? .ds f2 \\n(.f
|
|
Packit |
b099d7 |
.el .ie ?\\*(f3?? .ds f3 \\n(.f
|
|
Packit |
b099d7 |
.el .ie ?\\*(f4?? .ds f4 \\n(.f
|
|
Packit |
b099d7 |
.el .tm ? font overflow
|
|
Packit |
b099d7 |
.ft \\$1
|
|
Packit |
b099d7 |
..
|
|
Packit |
b099d7 |
.de fP
|
|
Packit |
b099d7 |
.ie !?\\*(f4?? \{\
|
|
Packit |
b099d7 |
. ft \\*(f4
|
|
Packit |
b099d7 |
. ds f4\"
|
|
Packit |
b099d7 |
' br \}
|
|
Packit |
b099d7 |
.el .ie !?\\*(f3?? \{\
|
|
Packit |
b099d7 |
. ft \\*(f3
|
|
Packit |
b099d7 |
. ds f3\"
|
|
Packit |
b099d7 |
' br \}
|
|
Packit |
b099d7 |
.el .ie !?\\*(f2?? \{\
|
|
Packit |
b099d7 |
. ft \\*(f2
|
|
Packit |
b099d7 |
. ds f2\"
|
|
Packit |
b099d7 |
' br \}
|
|
Packit |
b099d7 |
.el .ie !?\\*(f1?? \{\
|
|
Packit |
b099d7 |
. ft \\*(f1
|
|
Packit |
b099d7 |
. ds f1\"
|
|
Packit |
b099d7 |
' br \}
|
|
Packit |
b099d7 |
.el .tm ? font underflow
|
|
Packit |
b099d7 |
..
|
|
Packit |
b099d7 |
.ds f1\"
|
|
Packit |
b099d7 |
.ds f2\"
|
|
Packit |
b099d7 |
.ds f3\"
|
|
Packit |
b099d7 |
.ds f4\"
|
|
Packit |
b099d7 |
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n
|
|
Packit |
b099d7 |
.TH "MrmRegisterNamesInHierarchy" "library call"
|
|
Packit |
b099d7 |
.SH "NAME"
|
|
Packit |
b099d7 |
\fBMrmRegisterNamesInHierarchy\fP \(em Registers the values associated with the names referenced in UIL within a single hierarchy (for example, UIL callback function names or UIL identifier names)
|
|
Packit |
b099d7 |
.iX "MrmRegisterNamesIn\\%Hierarchy"
|
|
Packit |
b099d7 |
.iX "uil functions" "MrmRegisterNamesIn\\%Hierarchy"
|
|
Packit |
b099d7 |
.SH "SYNOPSIS"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.nf
|
|
Packit |
b099d7 |
#include <Mrm/MrmPublic\&.h>
|
|
Packit |
b099d7 |
\fBCardinal \fBMrmRegisterNamesInHierarchy\fP\fR(
|
|
Packit |
b099d7 |
\fBMrmHierarchy \fBhierarchy_id\fR\fR,
|
|
Packit |
b099d7 |
\fBMrmRegisterArglist \fBregister_list\fR\fR,
|
|
Packit |
b099d7 |
\fBMrmCount \fBregister_count\fR\fR);
|
|
Packit |
b099d7 |
.fi
|
|
Packit |
b099d7 |
.iX "MRM function" "MrmRegisterNamesIn\\%Hierarchy"
|
|
Packit |
b099d7 |
.iX "MrmRegisterNamesIn\\%Hierarchy" "definition"
|
|
Packit |
b099d7 |
.SH "DESCRIPTION"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The
|
|
Packit |
b099d7 |
\fBMrmRegisterNamesInHierarchy\fP
|
|
Packit |
b099d7 |
function
|
|
Packit |
b099d7 |
.iX "MrmRegisterNamesIn\\%Hierarchy" "description"
|
|
Packit |
b099d7 |
registers a vector of names and associated values
|
|
Packit |
b099d7 |
for access in MRM\&.
|
|
Packit |
b099d7 |
The values can be callback functions, pointers
|
|
Packit |
b099d7 |
to user-defined data, or any other values\&.
|
|
Packit |
b099d7 |
The information provided is used to resolve symbolic references
|
|
Packit |
b099d7 |
occurring in UID files to their run-time
|
|
Packit |
b099d7 |
values\&. For callbacks, this information
|
|
Packit |
b099d7 |
provides the procedure address required
|
|
Packit |
b099d7 |
by the Motif Toolkit\&.
|
|
Packit |
b099d7 |
For names used as identifiers in UIL, this information
|
|
Packit |
b099d7 |
provides any
|
|
Packit |
b099d7 |
run-time mapping the application needs\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
This function is similar to
|
|
Packit |
b099d7 |
\fBMrmRegisterNames\fP,
|
|
Packit |
b099d7 |
except that the scope of the names registered by
|
|
Packit |
b099d7 |
\fBMrmRegisterNamesInHierarchy\fP
|
|
Packit |
b099d7 |
is limited to the hierarchy specified by
|
|
Packit |
b099d7 |
\fIhierarchy_id\fP,
|
|
Packit |
b099d7 |
whereas the names registered by
|
|
Packit |
b099d7 |
\fBMrmRegisterNames\fP
|
|
Packit |
b099d7 |
have
|
|
Packit |
b099d7 |
global scope\&.
|
|
Packit |
b099d7 |
When MRM looks up a name, it first tries to find the name among those
|
|
Packit |
b099d7 |
registered for the given hierarchy\&.
|
|
Packit |
b099d7 |
If that lookup fails, it tries to find the name among those registered
|
|
Packit |
b099d7 |
globally\&.
|
|
Packit |
b099d7 |
.IP "\fIhierarchy_id\fP" 10
|
|
Packit |
b099d7 |
Specifies the hierarchy with which the names are to be associated\&.
|
|
Packit |
b099d7 |
.IP "\fIregister_list\fP" 10
|
|
Packit |
b099d7 |
Specifies a list of name/value pairs for the names to be registered\&.
|
|
Packit |
b099d7 |
Each name is a case-sensitive, NULL-terminated ASCII string\&.
|
|
Packit |
b099d7 |
Each value is a 32-bit quantity, interpreted as a procedure address if
|
|
Packit |
b099d7 |
the name is a callback function, and uninterpreted otherwise\&.
|
|
Packit |
b099d7 |
.IP "\fIregister_count\fP" 10
|
|
Packit |
b099d7 |
Specifies the number of entries in
|
|
Packit |
b099d7 |
\fIregister_list\fP\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The names in the list are case-sensitive\&.
|
|
Packit |
b099d7 |
The list can be either ordered or unordered\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Callback functions registered through
|
|
Packit |
b099d7 |
\fBMrmRegisterNamesInHierarchy\fP
|
|
Packit |
b099d7 |
can be either
|
|
Packit |
b099d7 |
regular or creation callbacks\&.
|
|
Packit |
b099d7 |
Regular callbacks have declarations determined by Motif Toolkit and user
|
|
Packit |
b099d7 |
requirements\&.
|
|
Packit |
b099d7 |
Creation callbacks have the same format as any other callback:
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.nf
|
|
Packit |
b099d7 |
\fBvoid \fBCallBackProc\fP\fR(
|
|
Packit |
b099d7 |
\fBWidget *\fBwidget_id\fR\fR,
|
|
Packit |
b099d7 |
\fBOpaque \fBtag\fR\fR,
|
|
Packit |
b099d7 |
\fBXmAnyCallbackStruct *\fBcallback_data\fR\fR);
|
|
Packit |
b099d7 |
.fi
|
|
Packit |
b099d7 |
.IP "\fIwidget_id\fP" 10
|
|
Packit |
b099d7 |
Specifies the widget ID associated with the widget performing the
|
|
Packit |
b099d7 |
callback (as in any callback function)\&.
|
|
Packit |
b099d7 |
.IP "\fItag\fP" 10
|
|
Packit |
b099d7 |
Specifies the tag value (as in any callback function)\&.
|
|
Packit |
b099d7 |
.IP "\fIcallback_data\fP" 10
|
|
Packit |
b099d7 |
Specifies a widget-specific data structure\&.
|
|
Packit |
b099d7 |
This data structure has a minimum of two members: event and reason\&.
|
|
Packit |
b099d7 |
The reason member is always set to
|
|
Packit |
b099d7 |
\fBMrmCR_CREATE\fP\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Note that the widget name and parent are available from the widget
|
|
Packit |
b099d7 |
record accessible through
|
|
Packit |
b099d7 |
\fIwidget_id\fP\&.
|
|
Packit |
b099d7 |
.SH "RETURN"
|
|
Packit |
b099d7 |
.iX "MrmSUCCESS"
|
|
Packit |
b099d7 |
.iX "MrmFAILURE"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
This function returns one of the following status return constants:
|
|
Packit |
b099d7 |
.IP "\fBMrmSUCCESS\fP" 10
|
|
Packit |
b099d7 |
The function executed successfully\&.
|
|
Packit |
b099d7 |
.IP "\fBMrmFAILURE\fP" 10
|
|
Packit |
b099d7 |
The function failed\&.
|
|
Packit |
b099d7 |
...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:17
|