Instance Method

element(at:associatedPoints:)

Gets the element type and (and optionally) the associated points for the path element at the specified index.

Declaration

func element(at index: Int, associatedPoints points: NSPointArray?) -> NSBezierPath.ElementType

Parameters

index

The index of the desired path element.

points

On input, a C-style array containing up to three NSPoint data types, or NULL if you do not want the points. On output, the data points associated with the specified path element.

Return Value

The type of the path element. For a list of constants, see NSBezierPath.ElementType.

Discussion

If you specify a value for the points parameter, your array must be large enough to hold the number of points for the given path element. Move, close path, and line segment commands return one point. Curve operations return three points.

For curve operations, the order of the points is controlPoint1 (points[0]), controlPoint2 (points[1]), endPoint (points[2]).

See Also

Accessing Elements of a Path

var elementCount: Int

The total number of path elements in the receiver's path.

func element(at: Int) -> NSBezierPath.ElementType

Returns the type of path element at the specified index.

func removeAllPoints()

Removes all path elements from the receiver, effectively clearing the path.

func setAssociatedPoints(NSPointArray?, at: Int)

Changes the points associated with the specified path element.