NAME

       MrmFetchSetValues  —  Fetches  the  values  to  be  set  from literals stored in UID files
       "MrmFetchSetValues" "uil functions" "MrmFetchSetValues"

SYNOPSIS

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

DESCRIPTION

       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" "description" MrmFetchSetValues fetches the  values  to  be  set  from
       literals stored in UID files.

       hierarchy_id
                 Specifies  the ID of the UID hierarchy that contains the specified 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 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 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.
       MrmFetchSetValues 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";

RETURN VALUE

       "MrmSUCCESS" "MrmPARTIAL_SUCCESS" "MrmBAD_HIERARCHY" "MrmFAILURE"

       This function returns one of the following status return constants:

       MrmSUCCESS
                 The function executed successfully.

       MrmPARTIAL_SUCCESS
                 At least one literal was successfully fetched.

       MrmBAD_HIERARCHY
                 The hierarchy ID was invalid.

       MrmFAILURE
                 The function failed.

RELATED

       MrmOpenHierarchyPerDisplay(3), XtSetValues(3).

                                                                             MrmFetchSetValues(3)