---
title: "element(at:associatedPoints:)"
framework: appkit
role: symbol
role_heading: Instance Method
path: "appkit/nsbezierpath/element(at:associatedpoints:)"
---

# element(at:associatedPoints:)

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

## Declaration

```swift
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

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

## Discussion

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

- [cgPath](appkit/nsbezierpath/cgpath.md)
- [elementCount](appkit/nsbezierpath/elementcount.md)
- [element(at:)](appkit/nsbezierpath/element(at:).md)
- [removeAllPoints()](appkit/nsbezierpath/removeallpoints().md)
- [setAssociatedPoints(_:at:)](appkit/nsbezierpath/setassociatedpoints(_:at:).md)