See Also
Enumerations
| Name | Values |
| SearchTypes | Contains |
| BeginsWith |
| Skins | None |
| Error |
| Success |
| Warning |
| Grey |
| DarkGrey |
| LightBlue |
| Blue |
| Lime |
| Pomelo |
| Orange |
| BlueGreen |
Constants
| Name | Type | Value |
| | | This class exposes no constants. |
Events
| Definition | Description |
| DoubleClick() | Fires when the user double-clicks the field in MultiSelect. |
| GotFocus() | Raised when the control receives focus. |
| LostFocus() | Raised when the control loses focus. |
| SelectionAdded( theItem as GraffitiWebPopupMenuItem ) | Fires when an item is selected in MultiSelect. |
| SelectionChanged() | This event is fired when one or more items in the popupmenu are selected. |
| SelectionRemoved( theItem as GraffitiWebPopupMenuItem ) | Fires when an items is deselected in MultiSelect. |
Methods
| Definition | Description |
| AddItem(ItemText as String) | Adds a new item to the list of items in the popupmenu. |
| AddItem(NewItem as GraffitiWebPopupMenuItem) | Adds a new item to list of items in the popupmenu. |
| ClosePopup() | Closes the popup, if it is shown. |
| DeselectAll(DoLockUpdate as Boolean = False) | Clears the current selection. When DoLockUpdate is True, regardless of the value of the LockUpdate property, execution is deferred. |
| FindItem(ItemIndex as Integer) As GraffitiWebPopupMenuItem | Returns the item matching the parameters. |
| FindItem(strText as String) As GraffitiWebPopupMenuItem |
| FindItemByTag (theTag as Variant) as GraffitiWebPopupMenuItem | Returns the item whose tag matches theTag. |
| GetItemByID(theID as String) as GraffitiWebPopupMenuItem | Returns the item whose automatically generated ID matched theID. |
| GetItemIndex(theItem as GraffitiWebPopupMenuItem) as Integer | Returns the index of the specified item. |
| GetItemIndexByTag(theTag as Variant) As Integer | Returns the index of the item whose tag matches theTag. |
| GetSelectedItems() As GraffitiWebPopupMenuItem | Returns an array of items that are currently selected. |
| GetSelectedItemsIndex() as Integer() | Returns an array of integers corresponding the indices of items selected in the popupmenu. |
| ItemCount() as Integer | Returns the current count (UBound + 1) of items added to the PopupMenu. |
| OpenPopup() | Opens the popup. |
| RemoveAllItems() | Removes all items from the popupmenu and updates the display. |
| RemoveItem (ItemIndex as Integer) | Removes the specified item from the list of items in the popupmenu. |
| RemoveItem (ItemText as String) |
| SetItemSelect(ItemIndex as Integer, ItemSelected as Boolean) | Will set the item’s Selected property to ItemSelected. |
| SetItemSelect(ItemText as String) | Will set the item’s Selected property to ItemSelected. |
| SetItemSelect(theItem as GraffitiWebPopupMenuItem) | Will set the item’s Selected property to ItemSelected. |
| SetItemState(ItemIndex as Integer, ItemState as Boolean) | Will enable or disable the item at ItemIndex. |
| SetText(theText as String) | Sets arbitrary text to the display for single select elements that do not have AllowAdd enabled. No effect otherwise. |
Properties
| Name | Type | Default Value | Description |
| AllowAdd | Boolean | False | When MultipleSelect = False, AllowAdd being tree will cause GraffitiWebPopupMenu to behave more like a combobox, allowing custom item input. |
| ContainerSkin | GraffitiWebPopupMenu.Skins | None | Sets the skin of the GraffitiWebPopupMenu. |
| DropdownSkin | GraffitiWebPopupMenu.Skins | None | Sets the skin of the dropdown menu. |
| Items() | GraffitiWebPopupMenuItem | Nil | The array of items. This array should not be changed directly, and only used as a reference. |
| LocaleCustom | Boolean | False | When True, will use the other Locale properties in place of the default text. |
| LocaleInputTooShort | String | “” | Text to display when the user hasn't entered enough text in the search field. |
| LocaleInputTooLong | String | “” | Text to display when the user has entered too many characters in the search field. |
| LocaleNewMatches | String | “No Matches Found” | Text displayed when the user's search returns an empty set of results. |
| LocaleSelectionTooLarge | String | “” | Text to display when the user has selected too many items. |
| LockUpdate | Boolean | False | When True, code execution to manipulate and update the element in the browser is deferred until set to False. |
| MaxSelecteditems | Integer | 5 | Limits the possible amount of selected items. |
| MinimumInputLength | Integer | 3 | Minimum number of characters user must enter before a search will be performed. If 0, all items will be shown by default. |
| MultipleSelect | Boolean | True | Determines whether the popupmenu will support selection of multiple items. |
| PlaceholderSearchText | String | “” | Text to display in the search box for instances where MultipleSelect = False. |
| PlaceholderText | String | “Please select an option” | The text to display when there are no items selected. |
| ReadOnly | Boolean | False | If True, the user cannot change the value of the control. |
| SearchThreshold | Integer | 10 | The number of characters required to trigger the search algorithm. Set to -1 to remove the search field. |
| SearchType | GraffitiWebPopupMenu.SearchTypes | Contains | Method used when performing a search from the search box for GraffitiWebPopupMenuItems. |
| SelectedItem | GraffitiWebPopupMenuItem | Nil | When MultipleSelect = False, this property will contain the currently selected item. |
| StyleTag | WebStyle | Nil | Style applied to tags when MultipleSelect = True. |
Examples
There are currently no examples for this class.