SETLINEJOIN

Syntax

short Escape(hDC, SETLINEJOIN, sizeof(int),lpNewJoin,lpOldJoin)

This escape specifies how a device driver will join two intersecting line segments. The intersection can form a rounded, squared, or mitered corner.

Parameter Type/Description  

hDC HDC Identifies the device context.  
lpNewJoin LPINT Points to a short-integer value that specifies the type of intersection. The possible values and their meanings are given in the following list:  
  Value Meaning
  –1 Line segments are joined by using the default GDI setting.
  0 Line segments are joined with a mitered corner; the outer edges of the lines extend until they meet at an angle. This is referred to as a miter join.
  1 Line segments are joined with a rounded corner; a semicircular arc with a diameter equal to the line width is drawn around the point where the lines meet. This is referred to as a round join.
  2 Line segments are joined with a squared end point; the outer edges of the lines are not extended. This is referred to as a bevel join.
lpOldJoin LPINT Points to a short-integer value that specifies the previous line join 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

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

If an application specifies a miter join but the angle of intersection is too small, the device driver ignores the miter setting and uses a bevel join instead.