# GraffitiListGroup
Class Inherits GraffitiWebUIControl
## About
A customizable and gorgeous single-column listbox replacement with easy support for single-row customization.
## Compatibility
### Framework API Version
| 1.0 | 2.0 |
| :---: | :---: |
| True | True |
### Web
| 32-Bit | 64-Bit |
| :---: | :---: |
| True | True |
## Event Definitions
| Name | Parameters | Return Type | Description |
| --- | :---: | :---: | --- |
| ItemContextPressed | item as GraffitiListGroupItem | (None) | Raised when the user right-clicks the specified item. |
| ItemDoublePressed | item as GraffitiListGroupItem | (None) | Raised when the user double-clicks the specified item. |
| ItemDragReordered | item as GraffitiListGroupItem <br> index as Integer | (None) | |
| ItemMouseEnter | item as GraffitiListGroupItem | (None) | Raised when the user's mouse enters the specified item's display area. |
| ItemMouseExit | item as GraffitiListGroupItem | (None) | Raised when the user's mouse exits the specified item's display area. |
| ItemPressed | item as GraffitiListGroupItem | (None) | Raised when the user clicks the specified item. |
| MouseEnter | (None) | (None) | |
| MouseExit | (None) | (None) | |
| Open | (None) | (None) | |
| SearchCompleted | criteria as String <br> results() as GraffitiListGroupItem | (None) | Raised when the user presses the Enter key in the search field. |
| SelectionChanged | (None) | (None) | Raised when a new item has been selected. |
| Shown | (None) | (None) | |
## Methods
| Name | Parameters | Return Type | Description |
| --- | :---: | :---: | --- |
| Add | item as GraffitiListGroupItem | (None) | Adds the specified item to the control. |
| AddAt | index as Integer <br> item as GraffitiListGroupItem | (None) | Adds the specified item at the supplied index. |
| IndexOf | item as GraffitiListGroupItem | Integer | Returns the index of the item within the internal items array, or -1 when not found. |
| ItemAt | index as Integer | GraffitiListGroupItem | Returns the item as the specified index within the internal items array, or Nil when not found. |
| LastIndex | (None) | Integer | The index of the last item within the internal items array. |
| Remove | item as GraffitiListGroupItem | (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. |
| ScrollTo | item as GraffitiListGroupItem | (None) | Scrolls to the specified item. |
| Search | value as String | (None) | Performs an in-browser search among all items for the specified value. |
| Attributes | Hidden | UpdateProperty | |
| Attributes | Hidden | UpdatePropertyMultiple | |
## Properties
| Name | Type | Default Value | Description |
| --- | :---: | :---: | --- |
| AllowDragReordering | Boolean | Nil | |
| Enabled | Boolean | Nil | |
| HasSearch | Boolean | Nil | When True, a search bar will be displayed. When users press enter, any item not matching the criteria will be hidden from view. Empty criteria shows all items. |
| Heading | String | Nil | Text to display at the very top of the control. |
| HeadingIndicator | WebUIControl.Indicators | Nil | Bootstrap indicator applied to the heading text. |
| HeadingStyle | GraffitiStyle | Nil | GraffitiStyle applied to the heading text. |
| SelectedItem | GraffitiListGroupItem | Nil | Currently selected item. |
