GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  XMTLOOKUPCOLORNAME (3)

NAME

XmtLookupColorName() - lookup the actual color name associated with a symbolic color name in an XmtColor Table.

CONTENTS

SYNOPSIS

   #include <Xmt/Color.h>

   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().
Search for    or go to Top of page |  Section 3 |  Main Index


Xmt XMTLOOKUPCOLORNAME (3) Motif Tools

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.