hpux man page for xtvagetvalues

XtVaGetValues() 														   XtVaGetValues()

Name
  XtVaGetValues - retrieve the current values of widget resources, using varargs argument style.

Synopsis
  void XtVaGetValues(object, ..., NULL)
	   Widget object;

Inputs
  object    Specifies the object whose resource values are to be returned; may be of class Object or any subclass thereof.

  ..., NULL A  NULL-terminated	variable-length  list  of  resource  names and the addresses at which the values of those resources are to be
	    stored.

Availability
  Release 4 and later.

Description
  XtVaGetValues() gets the values of the resources named in the variable length argument list from the specified widget or object and  stores
  those values at the addresses specified in the argument list.  It is the caller's responsibility to ensure that sufficient storage is allo-
  cated.  If XtVaTypedArg is specified, the following type argument field specifies the representation desired by the caller and the  follow-
  ing  size  argument  specifies the number of bytes allocated to store the result of the conversion.  If the size is insufficient, a warning
  message is issued and the list entry is skipped.

  XtVaGetValues() is identical to XtGetValues() except that the args array of resource names and values and the  num_args  argument  of  that
  function		      are		     replaced			 with			 a		      NULL-terminated
  variable-length argument list.

  See XtGetValues() for more information on this function.  See XtVaSetValues() for more information on using variable-length argument	lists
  to specify resources.

Example
  You can use XtVaGetValues() as follows:

     Pixel color;
     XFontStruct *font;
     String label;
     Widget w;

     XtVaGetValues(w,
		   XtNforeground, &color,
		   XtNfont, &font,
		   XtNlabel &label,
		   NULL);

See Also
  XtGetValues(1), XtSetValues(1), XtVaSetValues(1).

Xt - Resource Management													   XtVaGetValues()