XmQTspecifyRenderTable(3X)

     NAME
          XmQTspecifyRenderTable - A widget holding this trait can
          supply the names of its default render tables to any
          requestor

     SYNOPSIS
          #include <Xm/SpecRenderT.h>

          typedef struct {
                    int                             version;
                    XmSpecRenderGetTableProc        getRenderTable;
          } XmSpecRenderTraitRec, *XmSpecRenderTrait;
          XmRenderTable (*XmSpecRenderGetTableProc)(
          Widget,
          XtEnum);

     VERSION
          This page documents Motif 2.1.

     DESCRIPTION
          A widget holding the XmQTspecifyRenderTable trait is
          responsible for providing a requestor with a suitable render
          table.  Any manager widget holding this trait should provide
          the following three resources:

             o  A resource to hold the label render table

             o  A resource to hold the button render table

             o  A resource to hold the text render table

          The getRenderTable trait method of
          XmQTspecifyRenderTablewill use the values of the three
          resources as the basis for its returned information.

          The XmQTspecifyRenderTable trait is somewhat unusual in that
          other widgets do not access its trait method through the
          usual trait mechanisms.  Instead, other widgets access the
          getRenderTable trait method by calling
          XmeGetDefaultRenderTable.

          The following standard Motif widgets hold this trait:

             o  XmBulletinBoard and all its subclasses

             o  XmVendorShell and all its subclasses

             o  XmMenuShell

          The ExmGrid demonstration widget also installs this trait.

        The getRenderTable Trait Method
          XmRenderTable getRenderTable(
          Widget widget,
          XtEnum renderTableType);

          The getRenderTable trait method returns a render table
          corresponding to the renderTableType of widget widget.  This
          value (if non-NULL) is the internal value of the manager's
          render table, and should not be modified or freed.

          For example, given a manager widget named
          MyManagerWidgetthat supports the correct render table
          resources, the following is a sample implementation of the
          trait method:

          static XmRenderTable
          GetRenderTable( Widget widget,
                          XtEnum renderTableType)
          {
          XmMyManagerWidget mm = (XmMyManagerWidget) widget;
           switch(renderTableType) {
             case XmLABEL_RENDER_TABLE: return mm->my_manager.label_render_table;
             case XmBUTTON_RENDER_TABLE: return mm->my_manager.button_render_table;
             case XmTEXT_RENDER__RENDER_TABLE: return mm->my_manager.text_render_table;
           }
           return NULL;
          }

          widget    Specifies the widget containing render table
                    information.

          renderTableType
                    Specifies the desired type of render table; the
                    specified value must be one of the following:
                    XmLABEL_RENDER_TABLE, XmBUTTON_RENDER_TABLE, and
                    XmTEXT_RENDER_TABLE.

     RELATED
          XmBulletinBoard(3), VendorShell(3), XmMenuShell(3), and
          XmeGetDefaultRenderTable(3).