# Suggestion
Class
## About
`Suggestions.Suggestion` is one choice displayed by the editor. `Caption` is shown to the user, `InsertText` replaces the matched request range, `FilterText` is used when matching a query, and `Identifier` is the stable application value preserved with a committed tag.
## Methods
| Name | Parameters | Return Type | Description |
| --- | :---: | :---: | --- |
| Constructor | caption As String <br> insertText As String = "" <br> identifier As String = "" | (None) | Creates a suggestion with the supplied caption and inserted text. |
| Draw | g As Graphics <br> bounds As Rect <br> selected As Boolean <br> darkMode As Boolean | Boolean | Draws a custom suggestion row and returns True, or returns False to use the default drawing. |
## Properties
| Name | Type | Default Value | Description |
| --- | :---: | :---: | --- |
| Caption | String | (None) | Gets or sets the text displayed in the suggestion popup. |
| FilterText | String | (None) | Gets or sets the text used to filter this suggestion. |
| Icon | Picture | (None) | Gets or sets the optional icon drawn beside the caption. |
| Identifier | String | (None) | Gets or sets the stable application identifier preserved with a committed tag. |
| InsertText | String | (None) | Gets or sets the text that replaces the matched request range. |
| Tag | Variant | (None) | Gets or sets application-defined metadata associated with this suggestion. |
## Notes
### Custom Drawing
Subclass `Suggestions.Suggestion` and override `Draw` to render the complete popup row. Return `True` after drawing it. Return `False` to let the editor draw the icon and caption normally.