Instance Method

elementAtIndex:associatedPoints:

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

Declaration

- (NSBezierPathElement)elementAtIndex:(NSInteger)index associatedPoints:(NSPointArray)points;

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 NSBezierPathElement.

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

elementCount

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

- elementAtIndex:

Returns the type of path element at the specified index.

- removeAllPoints

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

- setAssociatedPoints:atIndex:

Changes the points associated with the specified path element.