ultrix man page for dwtfetchsetvalues

DwtFetchSetValues(3Dwt) 												   DwtFetchSetValues(3Dwt)

Name
       DwtFetchSetValues - Fetches the values to be set from literals stored in UID files.

Syntax
       #include <X11/DwtAppl.h>
       Cardinal DwtFetchSetValues(hierarchy_id, widget, args, num_args)
	    DRMHierarchy hierarchy_id;
	    Widget widget;
	    ArgList args;
	    Cardinal num_args;

Arguments
       hierarchy_id
		 Specifies  the  ID of the UID hierarchy that contains the specified literal.  The hierarchy_id was returned in a previous call to
		 DwtOpenHierarchy.

       widget	 Specifies the widget that is modified.

       args	 Specifies an argument list that identifies the widget arguments 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 DwtN followed
		 by the name that uniquely identifies this attribute tag.  For example, DwtNwidth 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.

Description
       The DwtFetchSetValues 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.  DwtFetchSetValues fetches the values to be set from literals stored in UID files.

       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.  DwtFetchSetValues allows a widget to be modified after creation using UID file
       values exactly as is done for creation values in DwtFetchWidget.

       As in DwtFetchWidget, 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
       DwtN.  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 = DwtNlabel;
       args[n].value = "OK_button_label";

Return Values
       This function returns one of these status return constants:

       DRMSuccess	 The   function   executed
			 successfully.
       DRMFailure	 The function failed.

See Also
       XtSetValues(3Dwt)

															   DwtFetchSetValues(3Dwt)