SoXtMaterialList(3IV)

NAME
     SoXtMaterialList (SoXtMtlList) - component which lets you edit a material
     interactively

INHERITS FROM
     SoXtComponent > SoXtMaterialList

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

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

          Functions from class SoXtMaterialList:

     SoXtMaterialList *  SoXtMtlListCreate(Widget parent = NULL, const char
                              *name = NULL, SbBool buildInsideParent = TRUE,
                              const char *dir = NULL)
     void                SoXtMtlListDelete(SoXtMtlList *this)
                         SoXtMtlListAddCB(SoXtMtlList *this,
                              SoXtMaterialListCB *f, void *userData = NULL)
                         SoXtMtlListRemoveCB(SoXtMtlList *this,
                              SoXtMaterialListCB *f, void *userData = NULL)

          Functions from class SoXtComponent:

     void                SoXtMtlListShow(SoXtMtlList *this)
     void                SoXtMtlListHide(SoXtMtlList *this)
     SbBool              SoXtMtlListIsVisible(SoXtMtlList *this)
     Widget              SoXtMtlListGetWidget(const SoXtMtlList *this)
     SbBool              SoXtMtlListIsTopLevelShell(const SoXtMtlList *this)
     Widget              SoXtMtlListGetShellWidget(const SoXtMtlList *this)
     Widget              SoXtMtlListGetParentWidget(const SoXtMtlList *this)
     void                SoXtMtlListSetSize(SoXtMtlList *this, const SbVec2s
                              *size)
     SbVec2s             SoXtMtlListGetSize(SoXtMtlList *this)
     Display *           SoXtMtlListGetDisplay(SoXtMtlList *this)
     void                SoXtMtlListSetTitle(SoXtMtlList *this, const char
                              *newTitle)
     const char *        SoXtMtlListGetTitle(const SoXtMtlList *this)
     void                SoXtMtlListSetIconTitle(SoXtMtlList *this, const char
                              *newIconTitle)
     const char *        SoXtMtlListGetIconTitle(const SoXtMtlList *this)
     void                SoXtMtlListSetWinCloseCB(SoXtMtlList *this,
                              SoXtComponentCB *func, void *data = NULL)
     SoXtComponent *     SoXtMtlListGetComp(Widget w)
     const char *        SoXtMtlListGetWidgetName(const SoXtMtlList *this)
     const char *        SoXtMtlListGetClassName(const SoXtMtlList *this)
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.

FUNCTIONS
     SoXtMaterialList *  SoXtMtlListCreate(Widget parent = NULL, const char
                              *name = NULL, SbBool buildInsideParent = TRUE,
                              const char *dir = NULL)
     void                SoXtMtlListDelete(SoXtMtlList *this)
          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.

                         SoXtMtlListAddCB(SoXtMtlList *this,
                              SoXtMaterialListCB *f, void *userData = NULL)
                         SoXtMtlListRemoveCB(SoXtMtlList *this,
                              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