|
Unix VPS
Support
FAQ
Network
Miscellaneous
|
| XmtLookupColorName(3) | FreeBSD Library Functions Manual | XmtLookupColorName(3) |
NAME
XmtLookupColorName() - lookup the actual color name associated with a symbolic color name in an XmtColor Table.SYNOPSIS
String XmtLookupColorName(XmtColorTable table, String symbol)
ARGUMENTS
INPUTS- table
- The XmtColorTable to be searched.
- symbol
- The symbolic color name to be looked up.
RETURNS
The actual color name associated with the symbol in table, or NULL, if none is found.
DESCRIPTION
XmtLookupColorName() returns the name of the color registered with symbolic name symbol in XmtColorTable table. If symbol is not found in table, then the parent of the specified color table is searched, and then the parent's parent is search, and so on until a definition of the symbolic color is found, or until a color table with no parent is is encountered. If the symbolic color is not found, XmtLookupColorName() returns NULL. This chain of color tables provides a ``scoping'' mechanism for symbolic color names like that used for variable names in C programming.The returned value is not guaranteed to be a legal color name; it is simply whatever name was registered with XmtRegisterColor() or a related function. Generally though, the color name returned by XmtLookupColorName() is suitable for allocation with XmtAllocColor() or a related function.
SEE ALSO
Chapter 4, Using Color,XmtAllocColor(), XmtColorTableGetParent(), XmtColorTableSetParent(), XmtCreateColorTable(), XmtDestroyColorTable(), XmtRegisterColor(), XmtRegisterColors(), XmtRegisterPixel(), XmtRegisterStandardColors(), XmtVaRegisterColors().
| Motif Tools | Xmt |
Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.