---
title: candidates
framework: appkit
role: symbol
role_heading: Instance Property
path: appkit/nscandidatelisttouchbaritem/candidates
---

# candidates

The array of candidate objects previously set by setCandidates(_:forSelectedRange:in:).

## Declaration

```swift
var candidates: [CandidateType] { get }
```

## See Also

### Populating the candidate list

- [setCandidates(_:forSelectedRange:in:)](appkit/nscandidatelisttouchbaritem/setcandidates(_:forselectedrange:in:).md)
- [attributedStringForCandidate](appkit/nscandidatelisttouchbaritem/attributedstringforcandidate.md)
- [allowsTextInputContextCandidates](appkit/nscandidatelisttouchbaritem/allowstextinputcontextcandidates.md)