SETLINECAP

  #define SETLINECAP 21    

  short Control(lpDevice, SETLINECAP, lpInData, lpOutData)    
  LPPDEVICE lpDevice;    
  LPINT lpInData;    
  LPINT lpOutData;    

The SETLINECAP escape sets the line end cap. An 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 end points.

Parameters

lpDevice

Points to a PDEVICE structure specifying the destination device.

lpInData

Points to a 16-bit variable that specifies the end-cap type. The variable can contain one of the following values.

Value Meaning

-1 Line segments are drawn by using the default 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.

lpOutData

Points to a 16-bit variable that receives the previous end-cap setting.

Return Value

The return value is positive if the escape is successful. Otherwise, it is negative.

Comments

The interpretation of this escape varies with page-description languages (PDLs). Consult your PDL documentation for its exact meaning.

This escape is also known as SETENDCAP.

See Also

SETLINEJOIN