---
title: "candidateListTouchBarItem(_:beginSelectingCandidateAt:)"
framework: appkit
role: symbol
role_heading: Instance Method
path: "appkit/nscandidatelisttouchbaritemdelegate/candidatelisttouchbaritem(_:beginselectingcandidateat:)"
---

# candidateListTouchBarItem(_:beginSelectingCandidateAt:)

Tells the delegate that the user has started touching one of the candidates in the candidate list item.

## Declaration

```swift
@MainActor optional func candidateListTouchBarItem(_ anItem: NSCandidateListTouchBarItem<AnyObject>, beginSelectingCandidateAt index: Int)
```

## Parameters

- `anItem`: The candidate list bar item that the user is interacting with.
- `index`: The index of the candidate that the user is currently touching.

## See Also

### Handling selection changes

- [candidateListTouchBarItem(_:changeSelectionFromCandidateAt:to:)](appkit/nscandidatelisttouchbaritemdelegate/candidatelisttouchbaritem(_:changeselectionfromcandidateat:to:).md)
- [candidateListTouchBarItem(_:endSelectingCandidateAt:)](appkit/nscandidatelisttouchbaritemdelegate/candidatelisttouchbaritem(_:endselectingcandidateat:).md)