XtVaGetValu(3x) — HP-UX ANSI C A.09.00

NAME

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

Synopsis

void XtVaGetValues(object, ..., NULL)

Widget object;

Inputs

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

..., NULLA 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 allocated. If XtVaTypedArg is specified, the following type argument field specifies the representation desired by the caller and the following 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);

Museum