dwtfetchsetvalues(3dwt) [ultrix man page]

DwtFetchSetValues(3Dwt) 												   DwtFetchSetValues(3Dwt)

Name
       DwtFetchSetValues - Fetches the values to be set from literals stored in UID files.

Syntax
       #include <X11/DwtAppl.h>
       Cardinal DwtFetchSetValues(hierarchy_id, widget, args, num_args)
	    DRMHierarchy hierarchy_id;
	    Widget widget;
	    ArgList args;
	    Cardinal num_args;

Arguments
       hierarchy_id
		 Specifies  the  ID of the UID hierarchy that contains the specified literal.  The hierarchy_id was returned in a previous call to
		 DwtOpenHierarchy.

       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 DwtN followed
		 by the name that uniquely identifies this attribute tag.  For example, DwtNwidth 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.

Description
       The DwtFetchSetValues 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.  DwtFetchSetValues fetches the values to be set from literals stored in UID files.

       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.  DwtFetchSetValues allows a widget to be modified after creation using UID file
       values exactly as is done for creation values in DwtFetchWidget.

       As in DwtFetchWidget, 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
       DwtN.  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 = DwtNlabel;
       args[n].value = "OK_button_label";

Return Values
       This function returns one of these status return constants:

       DRMSuccess	 The   function   executed
			 successfully.
       DRMFailure	 The function failed.

See Also
       XtSetValues(3Dwt)

															   DwtFetchSetValues(3Dwt)

Check Out this Related Man Page

DwtFetchLiteral(3Dwt)													     DwtFetchLiteral(3Dwt)

Name
       DwtFetchLiteral - Fetches a named literal from a UID file.

Syntax
       #include <X11/DwtAppl.h>
       int DwtFetchLiteral(hierarchy_id, index, display, value_return, type_return)
	    DRMHierarchy hierarchy_id;
	    String index;
	    Display *display;
	    caddr_t *value_return;
	    DRMCode *type_return;

Arguments
       hierarchy_id
		 Specifies  the  ID of the UID hierarchy that contains the specified literal.  The hierarchy_id was returned in a previous call to
		 DwtOpenHierarchy.

       index	 Specifies the UIL name of the literal (pixmap) to fetch.  You must define this name in UIL as an exported value.

       display	 Specifies the display used for the pixmap.  The display argument specifies the connection to the X server.  For more  information
		 on the Display structure see the Xlib function XOpenDisplay.

       value_return
		 Returns the ID of the named literal's value.

       type_return
		 Returns the named literal's data type.

Description
       The  DwtFetchLiteral function reads and returns the value and type of a literal (named value) that is stored as a public resource in a sin-
       gle UID file.  This function returns a pointer to the value of the literal.  For example, an integer is always returned as a pointer to	an
       integer, and a string is always returned as a pointer to a string.

       Applications should not use DwtFetchLiteral for fetching icon or color literals.  If this is attempted, DwtFetchLiteral returns an error.

Return Values
       This function returns one of these status return constants:

       DRMSuccess	 The   function   executed
			 successfully.
       DRMWrongType	 The operation encountered
			 an   unsupported  literal
			 type.
       DRMNotFound	 The literal was not found
			 in the UID file.
       DRMFailure	 The function failed.

See Also
       DwtFetchIconLiteral(3Dwt), DwtFetchColorLiteral(3Dwt)

															     DwtFetchLiteral(3Dwt)

Linux and UNIX Man Pages

dwtfetchsetvalues(3dwt) [ultrix man page]

Check Out this Related Man Page