Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XmtLookupColorName(3)	    Library Functions Manual	   XmtLookupColorName(3)

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

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 sym-
     bolic  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  suit-
     able for allocation with XmtAllocColor() or a related function.

SEE ALSO
     Chapter 4, Using Color,
     XmtAllocColor(), XmtColorTableGetParent(), XmtColorTableSetParent(),
     XmtCreateColorTable(), XmtDestroyColorTable(), XmtRegisterColor(),
     XmtRegisterColors(), XmtRegisterPixel(), XmtRegisterStandardColors(),
     XmtVaRegisterColors().

Xmt				   Motif Tools		   XmtLookupColorName(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmtLookupColorName&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help