XmeGetDefaultRenderTable(3UNIX SystemXmeGetDefaultRenderTable(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
Page 1 (printed 7/20/06)
XmeGetDefaultRenderTable(3UNIX SystemXmeGetDefaultRenderTable(3X)
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).
Page 2 (printed 7/20/06)
