XtGetSubresources(3Xt)                     XtGetSubresources(3Xt)



NAME
     XtGetSubresources,    XtGetApplicationResources    -     get
     subresources and application resources

SYNOPSIS
     void XtGetSubresources(w, base, name, class, resources,
     num-resources, args, num-args)
     Widget w;
     XtPointer base;
     String name;
     String class;
     XtResourceList resources;
     Cardinal num-resources;
     ArgList args;
     Cardinal num-args;

     void XtGetApplicationResources(w, base, resources, num-
     resources, args, num-args)
     Widget w;
     XtPointer base;
     XtResourceList resources;
     Cardinal num-resources;
     ArgList args;
     Cardinal num-args;

DESCRIPTION
     The XtGetSubresources function constructs a name and class
     list from the application name and class, the name and
     classes of all its ancestors, and the widget itself.  Then,
     it appends to this list the name and class pair passed in.
     The resources are fetched from the argument list, the
     resource database, or the default values in the resource
     list.  Then, they are copied into the subpart record.  If
     args is NULL, num-args must be 0.  However, if num-args is
     0, the args is not referenced.

     The XtGetApplicationResources function first uses the passed
     widget, which is usually an application shell, to construct
     a resource name and class list, Then, it retrieves the
     resources from the argument list, the resource database, or
     the resource list default values.  After adding base to each
     address,
     XtGetApplicationResources copies the resources into the ad-
     dress given in the resource list.  If args is NULL, num-args
     must be 0.  However, if num-args is 0, args is not refer-
     enced.  The portable way to specify application resources is
     to declare them as members of a structure and pass the ad-
     dress of the structure as the base argument.

   Arguments
     These functions accept the following arguments:




November, 1990                                                  1

XtGetSubresources(3Xt)                     XtGetSubresources(3Xt)



     args    Specifies the argument list to override resources
             obtained from the resource database.

     base    Specifies the base address of the subpart data
             structure where the resources should be written.

     class   Specifies the class of the subpart.

     name    Specifies the name of the subpart.

     num-args
             Specifies the number of arguments in the argument
             list.

     num-resources
             Specifies the number of resources in the resource
             list.

     resources
             Specifies the resource list for the subpart.

     w       Specifies the widget that wants resources for a sub-
             part or that identifies the resource database to
             search.

SEE ALSO
     XtGetResourceList(3Xt)

     X Toolkit Intrinsics - C Language Interface

     Xlib - C Language Interface

























2                                                  November, 1990