1MrmFetchSetValues(library call)                MrmFetchSetValues(library call)
2
3
4

NAME

6       MrmFetchSetValues  —  Fetches the values to be set from literals stored
7       in UID files
8

SYNOPSIS

10       #include <Mrm/MrmPublic.h>
11       Cardinal MrmFetchSetValues(
12       MrmHierarchy hierarchy_id,
13       Widget widget,
14       ArgList args,
15       Cardinal num_args);
16

DESCRIPTION

18       The MrmFetchSetValues function is similar to XtSetValues,  except  that
19       the  values  to  be  set  are  defined by the UIL named values that are
20       stored in the UID hierarchy.  MrmFetchSetValues fetches the  values  to
21       be set from literals stored in UID files.
22
23       hierarchy_id
24                 Specifies the ID of the UID hierarchy that contains the spec‐
25                 ified literal.  The value of hierarchy_id was returned  in  a
26                 previous call to MrmOpenHierarchyPerDisplay.
27
28       widget    Specifies the widget that is modified.
29
30       args      Specifies  an  argument list that identifies the widget argu‐
31                 ments to be modified as well as the index (UIL name)  of  the
32                 literal  that  defines the value for that argument.  The name
33                 part of each argument  (args[n].name)  must  begin  with  the
34                 string XmN followed by the name that uniquely identifies this
35                 attribute tag.  For example, XmNwidth is the  attribute  name
36                 associated  with  the  core  argument  width.  The value part
37                 (args[n].value) must be a string that gives  the  index  (UIL
38                 name) of the literal.  You must define all literals in UIL as
39                 exported values.
40
41       num_args  Specifies the number of entries in args.
42
43       This function sets the values on a widget,  evaluating  the  values  as
44       public  literal  resource  references  resolvable from a UID hierarchy.
45       Each literal is fetched from the hierarchy, and its value  is  modified
46       and  converted  as required.  This value is then placed in the argument
47       list and used as the actual value for an XtSetValues  call.   MrmFetch‐
48       SetValues  allows a widget to be modified after creation using UID file
49       values the same way creation values are used in MrmFetchWidget.
50
51       As in MrmFetchWidget, each argument whose value can be  evaluated  from
52       the  UID  hierarchy is set in the widget.  Values that are not found or
53       values in which conversion errors occur are not modified.
54
55       Each entry in the argument list identifies an argument to  be  modified
56       in  the  widget.   The  name part identifies the tag, which begins with
57       XmN.  The value part must be a string whose value is the index  of  the
58       literal.   Thus,  the following code would modify the label resource of
59       the widget to have the value of  the  literal  accessed  by  the  index
60       OK_button_label in the hierarchy:
61
62       args[n].name = XmNlabel;
63       args[n].value = "OK_button_label";
64

RETURN VALUE

66       This function returns one of the following status return constants:
67
68       MrmSUCCESS
69                 The function executed successfully.
70
71       MrmPARTIAL_SUCCESS
72                 At least one literal was successfully fetched.
73
74       MrmBAD_HIERARCHY
75                 The hierarchy ID was invalid.
76
77       MrmFAILURE
78                 The function failed.
79
81       MrmOpenHierarchyPerDisplay(3), XtSetValues(3).
82
83
84
85                                               MrmFetchSetValues(library call)
Impressum