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 report-
ing.
const char *string (in) String containing name of cap style -
one of “butt”, “projecting”, or
“round” - or a unique abbreviation of
one.
int *capPtr (out) Pointer to location in which to store
X cap style corresponding to string.
int cap (in) Cap style: one of CapButt, CapProject-
ing, 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 in-
dicate 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 un-
used. If string does not contain a valid cap style or an abbreviation
of one of these names, then an error message is stored in interpreter
interp's 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 cor-
responding to cap. If cap is not a legal cap style, then “unknown cap
style” is returned.
KEYWORDS
butt, cap style, projecting, round
Tk Tk_GetCapStyle(3tk)
Generated by dwww version 1.14 on Fri Jan 24 09:33:33 CET 2025.