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

FreeBSD Manual Pages


home | help
MrmFetchSetValues(3)	   Library Functions Manual	  MrmFetchSetValues(3)

       MrmFetchSetValues  -- Fetches the values	to be set from literals	stored
       in UID files

       #include	<Mrm/MrmPublic.h>
       Cardinal	MrmFetchSetValues(
       MrmHierarchy hierarchy_id,
       Widget widget,
       ArgList args,
       Cardinal	num_args);

       The MrmFetchSetValues function is similar to XtSetValues,  except  that
       the  values  to	be  set	 are  defined by the UIL named values that are
       stored in the UID hierarchy.  MrmFetchSetValues fetches the  values  to
       be set from literals stored in UID files.

		 Specifies the ID of the UID hierarchy that contains the spec-
		 ified literal.	 The value of hierarchy_id was returned	 in  a
		 previous call to MrmOpenHierarchyPerDisplay.

       widget	 Specifies the widget that is modified.

       args	 Specifies  an	argument list that identifies the widget argu-
		 ments to be modified as well as the index (UIL	name)  of  the
		 literal  that	defines	the value for that argument.  The name
		 part of each argument	(args[n].name)	must  begin  with  the
		 string	XmN followed by	the name that uniquely identifies this
		 attribute tag.	 For example, XmNwidth is the  attribute  name
		 associated  with  the	core  argument	width.	The value part
		 (args[n].value) must be a string that gives  the  index  (UIL
		 name) of the literal.	You must define	all literals in	UIL as
		 exported values.

       num_args	 Specifies the number of entries in args.

       This function sets the values on	a widget,  evaluating  the  values  as
       public  literal	resource  references  resolvable from a	UID hierarchy.
       Each literal is fetched from the	hierarchy, and its value  is  modified
       and  converted  as required.  This value	is then	placed in the argument
       list and	used as	the actual value for an	XtSetValues  call.   MrmFetch-
       SetValues  allows a widget to be	modified after creation	using UID file
       values the same way creation values are used in MrmFetchWidget.

       As in MrmFetchWidget, each argument whose value can be  evaluated  from
       the  UID	 hierarchy is set in the widget.  Values that are not found or
       values in which conversion errors occur are not modified.

       Each entry in the argument list identifies an argument to  be  modified
       in  the	widget.	  The  name part identifies the	tag, which begins with
       XmN.  The value part must be a string whose value is the	index  of  the
       literal.	  Thus,	 the following code would modify the label resource of
       the widget to have the value of	the  literal  accessed	by  the	 index
       OK_button_label in the hierarchy:

       args[n].name = XmNlabel;
       args[n].value = "OK_button_label";

       This function returns one of the	following status return	constants:

		 The function executed successfully.

		 At least one literal was successfully fetched.

		 The hierarchy ID was invalid.

		 The function failed.

       MrmOpenHierarchyPerDisplay(3), XtSetValues(3).



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

home | help