Volume 6A: Motif Programming Manual

colors for foreground color and background color pixels. Mrm allocates the other colors that are used in

the default colormap of the display. For this reason, you should not use this function to fetch icons for a visual

class other than the default.

On success, MrmFetchIconLiteral() fills in pixmap_return with the pixmap and returns MrmSUCCESS.

An application is responsible for freeing the pixmap using XFreePixmap(). The routine can also return

MrmBAD_HIERARCHY if the specified hierarchy is not valid, MrmNOT_FOUND if Mrm cannot find the icon or

xbitmapfile in the hierarchy, MrmWRONG_TYPE if Mrm finds a value but it is not an icon or xbitmapfile,

or MrmFAILURE if anything else goes wrong.

When MrmFetchIconLiteral() cannot allocate a color for an icon, it should substitute either black or white.

However, in early releases of Motif 1.2 this substitution does not take place, and the function returns

MrmNOT_FOUND when a color allocation fails. To avoid this problem, you should set pixmap−type widget resources,

such as XmNlabelPixmap, in a UIL module widget definition or by calling MrmFetchSetValues().

25.3.7 Widget Classes

The widget class type, or class_rec_name as it is called in UIL, is new in Motif 1.2. (This feature may have been

present in earlier versions, but was not documented until Motif 1.2) The type mainly supports the XmNentryClass

resource, which restricts the allowable children of a RowColumn widget. You can also use a widget class value as a

callback argument or with a user−defined ...