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
       symbolic	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 sym-
       bolic name symbol in XmtColorTable table. If symbol is not found	in ta-
       ble, 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 sym-
       bolic  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''	mecha-
       nism 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 Xmt-
       LookupColorName() 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().

Xmt				  Motif	Tools		 XmtLookupColorName(3)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | SEE ALSO

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

home | help