XmeGetDefaultRenderTable
Prev Xme Reference Pages Next

Name

XmeGetDefaultRenderTable — Returns the default render table associated with a specified widget

Synopsis

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

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:

  • XmBulletinBoard

  • XmMenuShell

  • VendorShell

If XmeGetDefaultRenderTable cannot find an ancestor holding the XmQTspecifyRenderTable trait, XmeGetDefaultRenderTable creates 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).

Prev Table of Contents Next
XmeGetDefaultPixel  XmeGetDirection