Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
MrmRegisterNamesInHierarchyLibrary Functions ManMrmRegisterNamesInHierarchy(3)

       MrmRegisterNamesInHierarchy -- Registers	the values associated with the
       names referenced	in UIL within a	single	hierarchy  (for	 example,  UIL
       callback	function names or UIL identifier names)

       #include	<Mrm/MrmPublic.h>
       Cardinal	MrmRegisterNamesInHierarchy(
       MrmHierarchy hierarchy_id,
       MrmRegisterArglist register_list,
       MrmCount	register_count);

       The  MrmRegisterNamesInHierarchy	 function  registers a vector of names
       and associated values for access	in MRM.	 The values  can  be  callback
       functions, pointers to user-defined data, or any	other values.  The in-
       formation provided is used to resolve symbolic references occurring  in
       UID  files  to  their  run-time values. For callbacks, this information
       provides	the procedure address required	by  the	 Motif	Toolkit.   For
       names  used  as	identifiers in UIL, this information provides any run-
       time mapping the	application needs.

       This function is	similar	to MrmRegisterNames, except that the scope  of
       the  names  registered by MrmRegisterNamesInHierarchy is	limited	to the
       hierarchy specified by hierarchy_id, whereas the	 names	registered  by
       MrmRegisterNames	have global scope.  When MRM looks up a	name, it first
       tries to	find the name among those registered for the given  hierarchy.
       If  that	lookup fails, it tries to find the name	among those registered

		 Specifies the hierarchy with which the	names are to be	 asso-

		 Specifies a list of name/value	pairs for the names to be reg-
		 istered.  Each	 name  is  a  case-sensitive,  NULL-terminated
		 ASCII	string.	  Each value is	a 32-bit quantity, interpreted
		 as a procedure	address	if the name is	a  callback  function,
		 and uninterpreted otherwise.

		 Specifies the number of entries in register_list.

       The  names  in the list are case-sensitive.  The	list can be either or-
       dered or	unordered.

       Callback	functions registered through  MrmRegisterNamesInHierarchy  can
       be either regular or creation callbacks.	 Regular callbacks have	decla-
       rations determined by Motif Toolkit and	user  requirements.   Creation
       callbacks have the same format as any other callback:

       void CallBackProc(
       Widget *widget_id,
       Opaque tag,
       XmAnyCallbackStruct *callback_data);

       widget_id Specifies the widget ID associated with the widget performing
		 the callback (as in any callback function).

       tag	 Specifies the tag value (as in	any callback function).

		 Specifies a widget-specific data structure.  This data	struc-
		 ture  has  a  minimum	of two members:	event and reason.  The
		 reason	member is always set to	MrmCR_CREATE.

       Note that the widget name and parent  are  available  from  the	widget
       record accessible through widget_id.

       This function returns one of the	following status return	constants:

		 The function executed successfully.

		 The function failed.



Want to link to this manual page? Use this URL:

home | help