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)