SoXtResource(3IV)

NAME
     SoXtResource (SoXtResource) - used to retrieve X resources for
     SoXtComponents and widgets

INHERITS FROM
     SoXtResource

SYNOPSIS
     #include <Inventor_c/Xt/SoXtResource.h>

          Functions from class SoXtResource:

     SoXtResource *      SoXtResourceCreate(Widget w)
     void                SoXtResourceDelete(SoXtResource *this)
     SbBool              SoXtResourceGetCol(SoXtResource *this, char *resName,
                              char *resClass, SbColor *c)
     SbBool              SoXtResourceGetInt(SoXtResource *this, char *resName,
                              char *resClass, short *i)
     SbBool              SoXtResourceGetUShort(SoXtResource *this, char
                              *resName, char *resClass, unsigned short *u)
     SbBool              SoXtResourceGetStr(SoXtResource *this, char *resName,
                              char *resClass, char **s)
     SbBool              SoXtResourceGetBool(SoXtResource *this, char
                              *resName, char *resClass, SbBool *b)
     SbBool              SoXtResourceGetFloat(SoXtResource *this, char
                              *resName, char *resClass, float *f)


DESCRIPTION
     This class provides an easy to use interface for retrieving X resource
     values for widgets and components. Rather than use standard Xt calls to
     traverse up a widget hierarchy, this class performs its own traversal so
     that it may provide special care for widgets which are Inventor
     components. For instance, the Inventor Material Editor top level widget
     is a Motif form widget. Its class name is thus XmForm. SoXtResource knows
     that the editor is an Inventor component, though, so it uses the class
     name provided by the editor (in this case "SoXtMaterialEditor") when
     looking up resource values.

     EXAMPLE:

          SoXtResource *xr;
          xr = SoXtResourceCreate( SoXtMtlEdGetWidget( materialEditor ) );
          SoXtResourceGetCol(xr, "tile1Color", "Tile1Color", &color);
          SoXtResourceGetInt(xr, "updateFrequency", "UpdateFrequency", &freq);



FUNCTIONS
     SoXtResource *      SoXtResourceCreate(Widget w)
     void                SoXtResourceDelete(SoXtResource *this)
          Constructor and destructor. The constructor takes the widget for
          which it will retrieve resource values.

     SbBool              SoXtResourceGetCol(SoXtResource *this, char *resName,
                              char *resClass, SbColor *c)
     SbBool              SoXtResourceGetInt(SoXtResource *this, char *resName,
                              char *resClass, short *i)
     SbBool              SoXtResourceGetUShort(SoXtResource *this, char
                              *resName, char *resClass, unsigned short *u)
     SbBool              SoXtResourceGetStr(SoXtResource *this, char *resName,
                              char *resClass, char **s)
     SbBool              SoXtResourceGetBool(SoXtResource *this, char
                              *resName, char *resClass, SbBool *b)
     SbBool              SoXtResourceGetFloat(SoXtResource *this, char
                              *resName, char *resClass, float *f)
          This returns the X resource value for the specified resource name
          and class. There is no need to specify the widget hierarchy; this is
          automatically computed in the constructor.


SEE ALSO
     X Resources (Xrm), X Intrinsics (Xt), SoXt, SoXtComponent