tk_nameofcapstyle(3tk) [opensolaris man page]

Tk_GetCapStyle(3TK)					       Tk Library Procedures					       Tk_GetCapStyle(3TK)

__________________________________________________________________________________________________________________________________________________

NAME

       Tk_GetCapStyle, Tk_NameOfCapStyle - translate between strings and cap styles

SYNOPSIS

       #include <tk.h>

       int
       Tk_GetCapStyle(interp, string, capPtr)

       CONST char *
       Tk_NameOfCapStyle(cap)

ARGUMENTS

       Tcl_Interp   *interp   (in)	Interpreter to use for error reporting.

       CONST char   *string   (in)	String containing name of cap style: one of ```butt'', ``projecting'', or ``round''.

       int	    *capPtr   (out)	Pointer to location in which to store X cap style corresponding to string.

       int	    cap       (in)	Cap style: one of CapButt, CapProjecting, or CapRound.
_________________________________________________________________

DESCRIPTION

       Tk_GetCapStyle  places  in  *capPtr  the  X  cap  style corresponding to string.  This will be one of the values CapButt, CapProjecting, or
       CapRound.  Cap styles are typically used in X graphics contexts to indicate how the end-points of lines should be capped.  See the X  docu-
       mentation for information on what each style implies.

       Under normal circumstances the return value is TCL_OK and interp is unused.  If string doesn't contain a valid cap style or an abbreviation
       of one of these names, then an error message is stored in interp->result, TCL_ERROR is returned, and *capPtr is unmodified.

       Tk_NameOfCapStyle is the logical inverse of Tk_GetCapStyle.  Given a cap style such as CapButt it  returns  a  statically-allocated  string
       corresponding to cap.  If cap isn't a legal cap style, then ``unknown cap style'' is returned.

KEYWORDS

       butt, cap style, projecting, round

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTk	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES

       Source for Tk is available on http://opensolaris.org.

Tk															       Tk_GetCapStyle(3TK)

Tk_GetReliefFromObj(3TK)				       Tk Library Procedures					  Tk_GetReliefFromObj(3TK)

__________________________________________________________________________________________________________________________________________________

NAME

       Tk_GetReliefFromObj, Tk_GetRelief, Tk_NameOfRelief - translate between strings and relief values

SYNOPSIS

       #include <tk.h>

       int																	   |
       Tk_GetReliefFromObj(interp, objPtr, reliefPtr)												   |

       int
       Tk_GetRelief(interp, name, reliefPtr)

       CONST char *
       Tk_NameOfRelief(relief)

ARGUMENTS

       Tcl_Interp   *interp	 (in)	   Interpreter to use for error reporting.

       Tcl_Obj	    *objPtr	 (in/out)													   |
					   String  value  contains name of relief (one of flat, groove, raised, ridge, solid, or sunken); internal |
					   rep will be modified to cache corresponding relief value.						   |

       char	    *string	 (in)														   |
					   Same as objPtr except description of relief is passed as a string.

       int	    *reliefPtr	 (out)	   Pointer to location in which to store relief value corresponding to objPtr or name.

       CONST char   *name		   Name of the relief.

       int	    relief	 (in)	   Relief  value   (one   of   TK_RELIEF_FLAT,	 TK_RELIEF_RAISED,   TK_RELIEF_SUNKEN,	 TK_RELIEF_GROOVE,
					   TK_RELIEF_SOLID, or TK_RELIEF_RIDGE).
_________________________________________________________________

DESCRIPTION

       Tk_GetReliefFromObj  places in *reliefPtr the relief value corresponding to the value of objPtr.  This value will be one of TK_RELIEF_FLAT, |
       TK_RELIEF_RAISED, TK_RELIEF_SUNKEN, TK_RELIEF_GROOVE, TK_RELIEF_SOLID, or TK_RELIEF_RIDGE.  Under normal circumstances the return value	is |
       TCL_OK  and interp is unused.  If objPtr doesn't contain one of the valid relief names or an abbreviation of one of them, then TCL_ERROR is |
       returned, *reliefPtr is unmodified, and an error message is stored in interp's result if interp	isn't  NULL.   Tk_GetReliefFromObj  caches |
       information about the return value in objPtr, which speeds up future calls to Tk_GetReliefFromObj with the same objPtr.			   |

       Tk_GetRelief is identical to Tk_GetReliefFromObj except that the description of the relief is specified with a string instead of an object. |
       This prevents Tk_GetRelief from caching the return value, so Tk_GetRelief is less efficient than Tk_GetReliefFromObj.

       Tk_NameOfRelief is the logical inverse of Tk_GetRelief.	Given a relief value it returns the corresponding string  (flat,  raised,  sunken,
       groove, solid, or ridge).  If relief isn't a legal relief value, then ``unknown relief'' is returned.

KEYWORDS

       name, relief, string

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTk	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES

       Source for Tk is available on http://opensolaris.org.

Tk									8.1						  Tk_GetReliefFromObj(3TK)