MrmFetchSetValues man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

MrmFetchSetValues(library call)		       MrmFetchSetValues(library call)

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);

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.

       hierarchy_id
		 Specifies the ID of the UID hierarchy that contains the spec‐
		 ified 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 argu‐
		 ments 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.   MrmFetch‐
       SetValues  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
       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(library call)
[top]

List of man pages available for HP-UX

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