MrmFetchColorLiteral(3X) OSF/Motif MrmFetchColorLiteral(3X)NAMEMrmFetchColorLiteral - Fetches a named color literal from a UID file
SYNOPSIS
#include <Mrm/MrmPublic.h>
int MrmFetchColorLiteral(hierarchy_id, index, display,
colormap_id, pixel) MrmHierarchyhierar‐
chy_id; String index; Display *display; Col‐
ormap colormap_id; Pixel *pixel;
DESCRIPTION
The MrmFetchColorLiteral function fetches a named color literal from a
UID file, and converts the color literal to a pixel color value. Spec‐
ifies the ID of the UID hierarchy that contains the specified literal.
The hierarchy_id was returned in a previous call to MrmOpenHierarchy‐
PerDisplay. Specifies the UIL name of the color literal to fetch. You
must define this name in UIL as an exported value. Specifies the dis‐
play used for the pixmap. The display argument specifies the connec‐
tion to the X server. For more information on the Display structure,
see the Xlib function XOpenDisplay. Specifies the ID of the color map.
If NULL, the default color map is used. Returns the ID of the color
literal.
RETURN VALUE
This function returns one of these status return constants: The func‐
tion executed successfully. The hierarchy ID was invalid. The color
literal was not found in the UIL file. The caller tried to fetch a
literal of a type not supported by this function. The function failed.
RELATED INFORMATIONMrmFetchBitmapLiteral(3X), MrmOpenHierarchyPerDisplay(3X), Mrm‐
FetchIconLiteral(3X), MrmFetchLiteral(3X), and XOpenDisplay(3X11).
MrmFetchColorLiteral(3X)
