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 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.