---
title: "candidateSelectionChanged(_:)"
framework: InputMethodKit
role: symbol
role_heading: Instance Method
platforms: [macOS 10.5+]
path: "inputmethodkit/imkinputcontroller/candidateselectionchanged(_:)"
---

# candidateSelectionChanged(_:)

Informs an input controller that the current candidate selection in the candidate window has changed.

## Declaration

```swift
func candidateSelectionChanged(_ candidateString: NSAttributedString!)
```

## Parameters

- `candidateString`: The changed candidate string.

## Discussion

Discussion Note this method is called to indicate user activity in the candidate window. The candidate object might not be the user’s final selection.

## See Also

### Tracking Selections

- [annotationSelected(_:forCandidate:)](inputmethodkit/imkinputcontroller/annotationselected(_:forcandidate:).md)
- [candidateSelected(_:)](inputmethodkit/imkinputcontroller/candidateselected(_:).md)