MrmFetchSetValues(3X)

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

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

     VERSION
          This page documents Motif 2.1.

     DESCRIPTION
          The MrmFetchSetValuesfunction 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.
          MrmFetchSetValuesfetches 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_idwas 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, XmNwidthis 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 XtSetValuescall.
          MrmFetchSetValuesallows 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
          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).