SoXtResource.3iv man page

SoXtResource — used to retrieve X resources for SoXtComponents and widgets

Inherits from

SoXtResource

Synopsis

#include <Inventor/Xt/SoXtResource.h>

Methods from class SoXtResource:

SoXtResource(Widget w)

~SoXtResource()

SbBool getResource(char *resName, char *resClass, SbColor &c)

SbBool getResource(char *resName, char *resClass, short &i)

SbBool getResource(char *resName, char *resClass, unsigned short &u)

SbBool getResource(char *resName, char *resClass, char *&s)

SbBool getResource(char *resName, char *resClass, SbBool &b)

SbBool getResource(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( materialEditor->getWidget() );
xr.getResource("tile1Color", "Tile1Color", color);
xr.getResource("updateFrequency", "UpdateFrequency", freq);

Methods

SoXtResource(Widget w)

~SoXtResource()
Constructor and destructor. The constructor takes the widget for which it will retrieve resource values.

SbBool getResource(char *resName, char *resClass, SbColor &c)

SbBool getResource(char *resName, char *resClass, short &i)

SbBool getResource(char *resName, char *resClass, unsigned short &u)

SbBool getResource(char *resName, char *resClass, char *&s)

SbBool getResource(char *resName, char *resClass, SbBool &b)

SbBool getResource(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.

Notes

Components will typically look up their own resources during buildWidget(). In order for a component to have its Inventor class name recognized by SoXtResource, it must call SoXtComponent::registerWidget() in its buildWidget() method. (This is done in every Inventor component.)

See Also

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

Info