Motif Widget Writer's Guide Migration Version

Motif 2.1 Widget Writer's Guide

XmeGetDefaultRenderTable

Returns the default render table associated with a specified widget

Format

#include <Xm/XmP.h>
XmRenderTable
XmeGetDefaultRenderTableWidget widgetunsigned
char 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).