Edit

Share via

D2D1_STROKE_STYLE_PROPERTIES structure (d2d1.h)

  • Article

Describes the stroke that outlines a shape.

Syntax

typedef struct D2D1_STROKE_STYLE_PROPERTIES {
  D2D1_CAP_STYLE  startCap;
  D2D1_CAP_STYLE  endCap;
  D2D1_CAP_STYLE  dashCap;
  D2D1_LINE_JOIN  lineJoin;
  FLOAT           miterLimit;
  D2D1_DASH_STYLE dashStyle;
  FLOAT           dashOffset;
} D2D1_STROKE_STYLE_PROPERTIES;

Members

startCap

Type: D2D1_CAP_STYLE

The cap applied to the start of all the open figures in a stroked geometry.

endCap

Type: D2D1_CAP_STYLE

The cap applied to the end of all the open figures in a stroked geometry.

dashCap

Type: D2D1_CAP_STYLE

The shape at either end of each dash segment.

lineJoin

Type: D2D1_LINE_JOIN

A value that describes how segments are joined. This value is ignored for a vertex if the segment flags specify that the segment should have a smooth join.

miterLimit

Type: FLOAT

The limit of the thickness of the join on a mitered corner. This value is always treated as though it is greater than or equal to 1.0f.

dashStyle

Type: D2D1_DASH_STYLE

A value that specifies whether the stroke has a dash pattern and, if so, the dash style.

dashOffset

Type: FLOAT

A value that specifies an offset in the dash sequence. A positive dash offset value shifts the dash pattern, in units of stroke width, toward the start of the stroked geometry. A negative dash offset value shifts the dash pattern, in units of stroke width, toward the end of the stroked geometry.

Remarks

The following illustration shows different dashOffset values for the same custom dash style.

Illustration of four dashes with the same style and different dashOffset values

Requirements

Requirement Value
Minimum supported client Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps | UWP apps]
Header d2d1.h