# GraffitiTagField
Class Inherits GraffitiUIControl
## About
GraffitiTagField is a simple and powerful way to allow users to select multiple members of a data set.
## Preview
Previous
Next
## Compatibility
### Framework API Version
| 1.0 | 2.0 |
| :---: | :---: |
| False | True |
### Console
| 32-Bit | 64-Bit |
| :---: | :---: |
| True | True |
### Desktop
| 32-Bit | 64-Bit |
| :---: | :---: |
| True | True |
### iOS
| 32-Bit | 64-Bit |
| :---: | :---: |
| False | True |
### Web
| 32-Bit | 64-Bit |
| :---: | :---: |
| True | True |
## Event Definitions
| Name | Parameters | Return Type | Description |
| --- | :---: | :---: | --- |
| Closing | (None) | (None) | |
| HeightChanged | (None) | (None) | Raised when the Height of the control has changed due to AutoHeight = True. |
| ItemPressed | item as GraffitiTag | (None) | Raised when the user has pressed and item. |
| Opening | (None) | (None) | |
| SelectionChanged | (None) | (None) | Raised when the user has changed the selection of items within the control either by adding or removing. |
## Methods
| Name | Parameters | Return Type | Description |
| --- | :---: | :---: | --- |
| Add | item as GraffitiTag | (None) | Adds a new item to the control. |
| AddAt | index as Integer <br> item as GraffitiTag | (None) | Adds the supplied item at the specified index. |
| IndexOf | item as GraffitiTag | Integer | Returns the index of the supplied item within the control's internal array. |
| LastIndex | (None) | Integer | Returns the index of the last item within the control's internal array. |
| Attributes | Hidden | raiseSelectionChanged | |
| Remove | item as GraffitiTag | (None) | Removes the specified item. |
| RemoveAll | (None) | (None) | Removes all items from the control. |
| RemoveAt | index as Integer | (None) | Removes the item at the specified index. |
| SelectedItems | (None) | GraffitiTag | Returns an array of the currently selected items. |
## Properties
| Name | Type | Default Value | Description |
| --- | :---: | :---: | --- |
| AddButton | GraffitiTag | Nil | Provides access to the GraffitiTag instance used for the button to search or add items. |
| AddFieldHint | String | Nil | Text displayed in the Add field when no user input has occurred. |
| AllowAdd | Boolean | Nil | When True and the user inputs text not found in the data set, a new GraffitiTag item will be generated -- and selected -- for that text. |
| Attributes | heightConstraint | iOSLayoutConstraint | |
| Attributes | items | Nil | |
| Attributes | menu | GraffitiTagFieldMenuScreen | |
| AutoHeight | Boolean | Nil | Setting this property to True will cause the control to automatically size itself vertically to show all selected items. |
| BackgroundColor | ColorGroup | Nil | Color applied to the background of the component. |
| BorderColor | ColorGroup | Nil | Color applied to the border of the component. |
| CornerHeight | Double | Nil | Height of the control's corners. |
| CornerWidth | Double | Nil | Width of the control's corners. |
| Field | MobileTextField | Nil | Control used as the Add field. |
| Font | Font | Nil | Font properties applied to all elements. |
| SearchFieldHint | String | "Search" | String displayed in the search field of the popup when no user input has occurred. |
| SearchFieldVisible | Boolean | Nil | Controls visibility of the search field. |
| TagBackgroundColor | ColorGroup | Nil | Background color applied to all tags that do not have an overriding BackgroundColor value. |
| TagBorderColor | ColorGroup | Nil | Border color applied to all tags that do not have an overriding BorderColor value. |
| TagCornerHeight | Double | Nil | Height of each tag's corners that do not have an overriding CornerHeight value. |
| TagCornerWidth | Double | Nil | Width of each tag's corners that do not have an overriding CornerWidth value. |
| TagTextColor | ColorGroup | Nil | Color applied to the text of each tag that does not have an overriding TextColor value. |
