Name

XtGetSubvalues — copy from subpart data structure to the argument list. 

Synopsis

void XtGetSubvalues(base, resources, num_resources, args, num_args)

    XtPointer base;
    XtResourceList resources;
    Cardinal num_resources;
    ArgList args;
    Cardinal num_args;

Arguments

baseSpecifies the base address of the subpart data structure for which the resources should be retrieved. 

resourcesSpecifies the nonwidget resource list. 

num_resources
Specifies the number of resources in the resource list.

argsSpecifies the argument list of name/address pairs that contain the resource names and the addresses into which the resource values are to be stored.  The arguments and the values that are passed in depend on the subpart.  The storage for argument values that are pointed to by the argument list must be deallocated by the application when no longer needed. 

num_argsSpecifies the number of arguments in the argument list. 

Description

XtGetSubvalues obtains resource values from the structure identified by base, and writes them in the provided argument list.  XtGetSubvalues expects the contents of args to be pointers to locations where the actual values can be put. 

The conjugate function XtSetSubvalues sets a widget’s values. 

XtGetSubvalues is used for obtaining resource data from entities that are not widgets.  For further discussion of nonwidget subclass resources, see XtGetSubresources. 

XtGetSubvalues is normally called in the get_values_hook method of a widget with a subpart.  It can never be called from the application because the application does not have the subpart resource list. 

Structures

XtResource is defined as follows in <X11/Intrinsic.h>:

typedef struct _XtResource {
String    resource_name;/∗ Resource name ∗/
String    resource_class;/∗ Resource class ∗/
String    resource_type;/∗ Representation type desired ∗/
Cardinal  resource_size;/∗ Size in bytes of representation ∗/
Cardinal  resource_offset;/∗ Offset from base to put resource value ∗/
String    default_type;/∗ Representation type of specified default ∗/
XtPointer default_addr;/∗ Address of resource default value ∗/
} XtResource, XtResourceList;

An Arg is defined as follows:

typedef struct {
String name;
XtArgVal value;
} Arg, ∗ArgList;

See Also

XtSetArg(1), XtVaGetSubvalues(1),
get_values_hook(4), initialize_hook(4).