Sets the pattern for drawing dashed lines.
- iOS 7.0+
- macOS 10.9+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
- Xcode 8.0+
- Core Graphics
A value that specifies how far into the dash pattern the line starts, in units of the user space. For example, a value of
0draws a line starting with the beginning of a dash pattern, and a value of
3means the line is drawn with the dash pattern starting at three units from its beginning.
An array of values that specify the lengths, in user space coordinates, of the painted and unpainted segments of the dash pattern.
For example, the array
[2,3]sets a dash pattern that alternates between a 2-unit-long painted segment and a 3-unit-long unpainted segment. The array
[1,3,4,2]sets the pattern to a 1-unit painted segment, a 3-unit unpainted segment, a 4-unit painted segment, and a 2-unit unpainted segment.Pass an empty array to clear the dash pattern so that all stroke drawing in the context uses solid lines.