MrmFetchSetValues man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

MrmFetchSetValues(3X)					 MrmFetchSetValues(3X)

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

SYNOPSIS
       #include <Mrm/MrmPublic.h>

       Cardinal MrmFetchSetValues(hierarchy_id, widget, args, num_args)
	       MrmHierarchy hierarchy_id;
	       Widget widget;
	       ArgList args;
	       Cardinal num_args;

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 fetches the values to be
       set  from  literals  stored  in UID files.  Specifies the ID of the UID
       hierarchy that contains the specified  literal.	The  hierarchy_id  was
       returned	 in  a previous call to MrmOpenHierarchyPerDisplay.  Specifies
       the widget that is modified.  Specifies an argument list	 that  identi‐
       fies  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 argu‐
       ment 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.	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. MrmFetchSet‐
       Values  allows  a  widget  to be modified after creation using UID file
       values exactly as is done for creation values 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  lit‐
       eral.  Thus,  the following code would modify the label resource of the
       widget to have the value of the literal accessed by the	index  OK_but‐
       ton_label in the hierarchy:

       args[n].name = XmNlabel; args[n].value = "OK_button_label";

RETURN VALUE
       This  function  returns one of these status return constants: The func‐
       tion executed successfully.  At	least  one  literal  was  successfully
       fetched.	 The hierarchy ID was invalid.	The function failed.

SEE ALSO
       MrmOpenHierarchyPerDisplay(3X), XtSetValues(3Xt)

							 MrmFetchSetValues(3X)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net