tk_getcapstyle(3)
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'', ``project
ing'', 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 Cap
- Butt, CapProjecting, or CapRound.
DESCRIPTION
Tk_GetCapStyle places in *capPtr the X cap style corre
sponding to string. This will be one of the values Cap
Butt, CapProjecting, or CapRound. Cap styles are typi
cally used in X graphics contexts to indicate how the endpoints of lines should be capped. See the X documentation
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_GetCap
Style. 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