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
       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''	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.1-RELEASE+and+Ports>

home | help