XtGetApplicationResources.3Xt.z(3Xt)



     X Version 11 (Release 3)                   XtGetSubresources(3Xt)



     NAME
          XtGetSubresources, XtGetApplicationResources - obtain
          subresources or application resources

     SYNTAX
          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;

     ARGUMENTS
          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
                    subpart or that identifies the resource database
                    to search.

     DESCRIPTION
          The XtGetSubresources function constructs a name/class list
          from the application name/class, the name/classes of all its



     Licensed material--property of copyright holder(s)         Page 1



                         X Version 11 (Release 3)
XtGetSubresources(3Xt)



          ancestors, and the widget itself.  Then, it appends to this
          list the name/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 zero.  However, if num_args is zero, the argument
          list 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 address given in the resource list.  If args is NULL,
          num_args must be zero.  However, if num_args is zero, the
          argument list is not referenced.  The portable way to
          specify application resources is to declare them as members
          of a structure and pass the address of the structure as the
          base argument.

     SEE ALSO
          XtGetResourceList(3Xt)
          X Toolkit Intrinsics - C Language Interface
          Xlib - C Language X Interface






























     Licensed material--property of copyright holder(s)         Page 2

Museum