NAME

       SoXtMaterialList — component which lets you edit a material interactively

INHERITS FROM

       SoXtComponent > SoXtMaterialList

SYNOPSIS

       #include <Inventor/Xt/SoXtMaterialList.h>

     typedef void        SoXtMaterialListCB(void *userData, const SoMaterial *mtl)

          Methods from class SoXtMaterialList:

                         SoXtMaterialList(Widget  parent  = NULL, const char *name = NULL, SbBool
                              buildInsideParent = TRUE, const char *dir = NULL)
                         ~SoXtMaterialList()
                         addCallback(SoXtMaterialListCB *f, void *userData = NULL)
                         removeCallback(SoXtMaterialListCB *f, void *userData = NULL)

          Methods from class SoXtComponent:

     virtual void            show()
     virtual void            hide()
     SbBool                  isVisible()
     Widget                  getWidget() const
     SbBool                  isTopLevelShell() const
     Widget                  getShellWidget() const
     Widget                  getParentWidget() const
     void                    setSize(const SbVec2s &size)
     SbVec2s                 getSize()
     Display *               getDisplay()
     void                    setTitle(const char *newTitle)
     const char *            getTitle() const
     void                    setIconTitle(const char *newIconTitle)
     const char *            getIconTitle() const
     void                    setWindowCloseCallback(SoXtComponentCB *func, void *data = NULL)
     static SoXtComponent *  getComponent(Widget w)
     const char *            getWidgetName() const
     const char *            getClassName() const

DESCRIPTION

       This class is used to choose an SoMaterial from  palettes  of  predefined  materials  (for
       example,  gold, silver, or bronze from the metal palette; emerald, pearl, or ruby from the
       stones palette). The chosen material is passed to callback functions registered with  this
       component.

METHODS

                         SoXtMaterialList(Widget  parent  = NULL, const char *name = NULL, SbBool
                              buildInsideParent = TRUE, const char *dir = NULL)
                         ~SoXtMaterialList()
          The constructor is passed a directory name which serves as the home directory  for  the
          material  palettes. You can have any number of palettes in this directory. A palette is
          a subdirectory that contains  Inventor  data  files,  where  each  file  describes  one
          material. Predefined Inventor materials are found in /usr/share/data/materials.

                         addCallback(SoXtMaterialListCB *f, void *userData = NULL)
                         removeCallback(SoXtMaterialListCB *f, void *userData = NULL)
          Register  functions  that  will be called whenever the user chooses a new material from
          the list. Each callback when invoked will be passed the userData pointer, along with  a
          pointer to the newly selected material.

SEE ALSO

       SoXtComponent, SoCallbackList, SoMaterial, SoXtMaterialEditor

                                                                          SoXtMaterialList(3IV)()