XmeGetDefaultRenderTable(3X)

     NAME
          XmeGetDefaultRenderTable - Returns the default render table
          associated with a specified widget

     SYNOPSIS
          #include <Xm/XmP.h>
          XmRenderTable XmeGetDefaultRenderTable(
          Widget widget,
          unsigned char renderTableType);

     VERSION
          This page documents Motif 2.1.

     DESCRIPTION
          XmeGetDefaultRenderTable returns the default render table
          associated with widget widget.

          To determine the default render table,
          XmeGetDefaultRenderTable scans the parent hierarchy of
          widget, searching for the first ancestor to hold the
          XmQTspecifyRenderTable trait.  If it finds one,
          XmeGetDefaultRenderTable calls the getRenderTable trait
          method of the XmQTspecifyRenderTable trait.  This trait
          method returns the appropriate default render table based on
          renderTableType.

          In the standard Motif widget set, the following widgets hold
          the XmQTspecifyRenderTable trait:

             o  XmBulletinBoard

             o  XmMenuShell

             o  VendorShell

          If XmeGetDefaultRenderTable cannot find an ancestor holding
          the XmQTspecifyRenderTable trait,
          XmeGetDefaultRenderTablecreates a render table from the
          default system font.

          widget    The name of the widget whose render table you are
                    seeking.

          renderTableType
                    You must specify one of the following:

                    XmLABEL_RENDER_TABLE
                              Specifies a request for the default
                              render table associated with labels.
                              Users or applications typically specify
                              this default through the
                              XmNlabelRenderTable resource of
                              XmBulletinBoard, VendorShell, or
                              XmMenuShell.

                    XmTEXT_RENDER_TABLE
                              Specifies a request for the default
                              render table associated with text.
                              Users or applications typically specify
                              this default through the
                              XmNtextRenderTable resource of
                              XmBulletinBoard, VendorShell, or
                              XmMenuShell.

                    XmBUTTON_RENDER_TABLE
                              Specifies a request for the default
                              render table associated with buttons.
                              Users or applications typically specify
                              this default through the
                              XmNbuttonRenderTable resource of
                              XmBulletinBoard, VendorShell, or
                              XmMenuShell.

     RETURN
          Returns the default render table associated with widget
          widget.  Your widget should always make a copy of the
          returned render table and use the copy rather than the
          original.

     RELATED
          XmeRenderTableGetDefaultFont(3).