REF XT_RESOURCE                                     Adrian Howard Sep 91

       COPYRIGHT University of Sussex 1990. All Rights Reserved.

>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
<<<<<<<<<<<<<<<<<<<<<                             >>>>>>>>>>>>>>>>>>>>>>
<<<<<<<<<<<<<<<<<<<<<     RESOURCE MANAGEMENT     >>>>>>>>>>>>>>>>>>>>>>
<<<<<<<<<<<<<<<<<<<<<                             >>>>>>>>>>>>>>>>>>>>>>
<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

This REF file  details the procedures  that are suplied  by the  library
package LIB * XT_RESOURCE  which provides  the Pop-11  interface to  the
resource management related X Toolkit Intrinsics.

         CONTENTS - (Use <ENTER> g to access required sections)

  1   Introduction

  2   Predefined Resources

  3   LIB XT_RESOURCE

  4   LIB FAST_XT_RESOURCE



---------------
1  Introduction
---------------

The library  LIB * XT_RESOURCE  provides  the Pop-11  interface  to  the
resource management related X Toolkit Intrinsics. The library allows the
following functions to be performed:

   #  Fetching a widget classes resource list structure.
   #  Fetching the resources of an application.
   #  Fetching the values of a widgets resources.
   #  Modifying the values of a widgets resources.

The  exact  structure  of  arguments  and  results  for  the   following
procedures is as discussed in REF * XTOOLKIT.

For full details see chapter 9 of:

               X Toolkit Intrinsics - C Language Interface
                             X Window System
                         X Version 11, Release 4

        Copyright (C)  1985,  1986,  1987,  1988,  Massachusetts
        Institute of Technology,  Cambridge, Massachusetts,  and
        Digital Equipment Corporation, Maynard, Massachusetts.




-----------------------
2  Predefined Resources
-----------------------

The intrinics define the following resource types:

       Resource Type          Structure or Field Type
       -------------          -----------------------
       XtR AcceleratorTable   XptAccelerators
       XtR Atom               XptAtom
       XtR Bitmap             XptBitmap
       XtR Boolean            XptBoolean
       XtR Bool               XptBoolean
       XtR Callback           XptCallbackList
       XtR Cardinal           XptCardinal
       XtR Color              XptColor
       XtR Colormap           XptColormap
       XtR Cursor             XptCursor
       XtR Dimension          XptDimension
       XtR Display            XptDisplayPtr
       XtR Enum               XptEnum
       XtR File               FILE*
       XtR Float              XptFloat
       XtR Font               XptFont
       XtR FontStruct         :XFontStruct
       XtR Function           XptProcedure
       XtR Geometry           XptString
       XtR InitialState       XptInt
       XtR Int                XptInt
       XtR LongBoolean        XptLongBoolean
       XtR Object             XptObject
       XtR Pixel              XptPixel
       XtR Pixmap             XptPixmap
       XtR Pointer            XptPointer
       XtR Position           XptPosition
       XtR Screen             XptXScreenPtr
       XtR Short              XptShort
       XtR String             XptString
       XtR StringArray        XptStringList
       XtR StringTable        XptStringList
       XtR TranslationTable   XptTranslations
       XtR UnsignedChar       XptUnsignedChar
       XtR Visual             :XptVisual
       XtR Widget             XptWidget
       XtR WidgetClass        XptWidgetClass
       XtR WidgetList         XptWidgetList
       XtR Window             XptWindow




------------------
3  LIB XT_RESOURCE
------------------

XtGetResourceList(widgetclass, resourcelistptr,              [procedure]
                  cardinalptr)
        Get the resource list structure for a particular class.


XtGetConstraintResourceList(widget, resourcelistptr,         [procedure]
                            cardinalptr)
        Get the constraint resource list structure for a widget class.


XtGetApplicationResources(widget, base, resourcelist,        [procedure]
                          resource, arglist, argc);
XtVaGetApplicationResources(widget, base, resourcelist,      [procedure]
                            resource, argvarargs);
        Get the  overall resources  of an  application (non-varargs  and
        varargs versions).


XtGetValues(widget, arglist, cardinal)                       [procedure]
XtVaGetValues(widget, argvarargs)                            [procedure]
        Get the values of a  widgets resources (non-varargs and  varargs
        versions).


XtGetSubvalues(base, resourcelist, cardinal,                 [procedure]
               arglist, argc)
XtVaGetSubvalues(base, resourcelist, cardinal,               [procedure]
                 argvarargs)
        Get the  values of  non-widget  resource data  (non-varargs  and
        varargs versions).


XtSetValues(widget, arglist, cardinal)                       [procedure]
XtVaSetValues(widget, argvarargs)                            [procedure]
        Modify  a  widgets  resource  values  (non-varargs  and  varargs
        versions).


XtSetSubvalues(base, resourcelist, cardinal,                 [procedure]
               arglist, argc)
XtVaSetSubvalues(base, resourcelist, cardinal,               [procedure]
                argvarargs)
        Modify a widgets non-widget  resources (non-varargs and  varargs
        versions).


XtDatabase(displayptr) -> xrmdatabase                        [procedure]
        XtDatabase returns the fully merged resource database (built  by
        * XtDisplayInitialize)  that  is  associated  with  the  display
        referred  to  by  displayptr.  If  this  display  has  not  been
        initialized by XtDisplayInitialize, the results are undefined.

        See * XptXrmDatabase and REF * XResourceDB.


XptResourcePtr                                    [shadowclass typespec]
        This shadowclass provides  support for  pointers to  XptResource
        structures.  See  REF * XPT_GENERALTYPES  for  details  of   the
        XptResource typespec. See REF * SHADOWCLASS for more details  on
        shadowclasses.


XptResourceList                                   [shadowclass typespec]
        This shadowclass  provides support  for pointers  to  contiguous
        series of XptResource structures. See REF * XPT_GENERALTYPES for
        details of the XptResource  typespec. See REF * SHADOWCLASS  for
        more details on shadowclasses.




-----------------------
4  LIB FAST_XT_RESOURCE
-----------------------

fast_XtGetResourceList(widgetclass, resourcelistptr,         [procedure]
                  cardinalptr)
fast_XtGetConstraintResourceList(widget, resourcelistptr,    [procedure]
                            cardinalptr)
fast_XtGetApplicationResources(widget, base, resourcelist,   [procedure]
                          resource, arglist, argc);
fast_XtVaGetApplicationResources(widget, base, resourcelist, [procedure]
                            resource, argvarargs);
fast_XtGetValues(widget, arglist, cardinal)                  [procedure]
fast_XtVaGetValues(widget, argvarargs)                       [procedure]
fast_XtGetSubvalues(base, resourcelist, cardinal,            [procedure]
               arglist, argc)
fast_XtVaGetSubvalues(base, resourcelist, cardinal,          [procedure]
                 argvarargs)
fast_XtSetValues(widget, arglist, cardinal)                  [procedure]
fast_XtVaSetValues(widget, argvarargs)                       [procedure]
fast_XtSetSubvalues(base, resourcelist, cardinal,            [procedure]
               arglist, argc)
fast_XtVaSetSubvalues(base, resourcelist, cardinal,          [procedure]
                argvarargs)
fast_XtDatabase(displayptr) -> xrmdatabase                   [procedure]
        As for the procedures  in LIB * XT_RESOURCE, but without  checks
        for valid arguments.  These procedures  should only  be used  in
        fully debugged programs. See REF * XTOOLKIT for full details  of
        the Poplog X  naming conventions for  non-checking and  checking
        procedures.



--- C.x/x/pop/ref/xt_resource
--- Copyright University of Sussex 1991. All rights reserved.
