SETLINECAP

short Escape(hdc, SETLINECAP, sizeof(int),lpNewCap,lpOldCap)

The SETLINECAP printer escape sets the line end cap.

A line end cap is that portion of a line segment that appears on either end of the segment. The cap may be square or circular. It can extend past or remain flush with the specified segment endpoints.

Parameters

hdc

HDC Identifies the device context.

lpNewCap

LPINT Points to a short integer that specifies the end-cap type. Following are the possible values and their meanings:

Value Meaning

–1 Line segments are drawn by using the default graphics device interface (GDI) end cap.
0 Line segments are drawn with a squared end point that does not project past the specified segment length.
1 Line segments are drawn with a rounded end point; the diameter of this semicircular arc is equal to the line width.
2 Line segments are drawn with a squared end point that projects past the specified segment length. The projection is equal to half the line width.

lpOldCap

LPINT Points to a short integer that specifies the previous end-cap setting.

Return Value

The return value specifies the outcome of the escape. It is positive if the escape is successful. Otherwise, it is negative.

Comments

This escape is used only by PostScript printer drivers.

The interpretation of this escape varies with page-description languages (PDLs). For its exact meaning, consult the PDL documentation.

This escape is also known as SETENDCAP.