MrmFetchColorLiteral - Man Page

#include <Mrm/MrmPublic​.h>
Cardinal MrmFetchColorLiteral(
MrmHierarchy hierarchy_id,
const char *index,
Display *display,
Colormap colormap_id,
Pixel *pixel);

The MrmFetchColorLiteral function fetches a named color literal from a UID file, and converts the color literal to a pixel color value​.

hierarchy_id

Specifies the ID of the UID hierarchy that contains the specified literal​. The value of hierarchy_id was returned in a previous call to MrmOpenHierarchyPerDisplay​.

index

Specifies the UIL name of the color literal to fetch​. You must define this name in UIL as an exported value​.

display

Specifies the display used for the pixmap​. The display argument specifies the connection to the X server​. For more information on the Display structure, see the Xlib function XOpenDisplay​.

colormap_id

Specifies the ID of the color map​. If colormap_id is NULL, the default color map is used​.

pixel

Returns the ID of the color literal​.

This function returns one of the following status return constants:

MrmSUCCESS

The function executed successfully​.

MrmBAD_HIERARCHY

The hierarchy ID was invalid​.

MrmNOT_FOUND

The color literal was not found in the UIL file​.

MrmWRONG_TYPE

The caller tried to fetch a literal of a type not supported by this function​.

MrmFAILURE

The function failed​.

MrmFetchBitmapLiteral(3), MrmOpenHierarchyPerDisplay(3), MrmFetchIconLiteral(3), MrmFetchLiteral(3), and XOpenDisplay(3)​.

MrmFetchIconLiteral(3), MrmFetchLiteral(3).