---
title: insertDictationResultPlaceholder
framework: uikit
role: symbol
role_heading: Instance Property
path: uikit/uitextinput/insertdictationresultplaceholder
---

# insertDictationResultPlaceholder

Asks for the placeholder object to use while generating dictation results.

## Declaration

```swift
optional var insertDictationResultPlaceholder: Any { get }
```

## Return Value

Return Value A placeholder object to use to identify the dictation results. This value must not be nil.

## Discussion

Discussion Implementation of this method is optional but can be done when you want to provide a specific rectangle for the placeholder animation while the dictation results are being processed. The object you return from this method is passed to the frame(forDictationResultPlaceholder:) method later. The actual contents of the object are not accessed by UIKit but you can use the object to store whatever information you need to identify the location for the animation. UIKit maintains a strong reference to your placeholder object until the removeDictationResultPlaceholder(_:willInsertResult:) method is called. You must implement both this method and the removeDictationResultPlaceholder(_:willInsertResult:) method for placeholders to be used.

## See Also

### Using dictation

- [dictationRecordingDidEnd()](uikit/uitextinput/dictationrecordingdidend().md)
- [dictationRecognitionFailed()](uikit/uitextinput/dictationrecognitionfailed().md)
- [insertDictationResult(_:)](uikit/uitextinput/insertdictationresult(_:).md)
- [frame(forDictationResultPlaceholder:)](uikit/uitextinput/frame(fordictationresultplaceholder:).md)
- [removeDictationResultPlaceholder(_:willInsertResult:)](uikit/uitextinput/removedictationresultplaceholder(_:willinsertresult:).md)