Select

Description

The Select control displays a popup list of choices. When one is picked, the list is closed. Select controls can be grouped. Select control groups may be horizontal or vertical.

To add a Select control to your app, choose the Select icon in the Toolbar, then position it on the Design Screen. Use the Property Editor to set the properties you need.

Properties

Standard properties are supported, plus:

addItem(item,value)	Add a new item to the list.value is optional. Runtime only.
clear()	Clear all items from the list. . Runtime only.
getItemCount()	Return the number of items. Runtime only.
groupBegin	If you have a group of buttons, set this to Yes on the first one. Design time only.
groupEnd	If you have a group of buttons, set this to Yes on the last one. Design time only.
icon	Set to false for no icon. You have a choice of 18 standard icons. Design time only.
iconPos	Position of the icon. Can be none, left, right, top, bottom or notext. Design time only.
inline	If true, then width is full width of the screen. Design time only.
items	The list of items to pop up when control is selected. Design time only.
List(n)	Get the text of item n.
ListCount	The number of items. Same as getItemCount().
ListIndex	Gets or set the current selection number. If set, calls the control’s _onclick() and _onchange() functions.
multipleSelection	Allow more than one item to be selected? nativeMenu must be false. Design Time only.
nativeMenu	Use the native picker instead of the jQuery Mobile picker. Native picker is often nicer on mobile devices. Design time only.
overlayTheme	Color theme for the popup list of choices. Design time only.
placeholder	Identifies which option is the default. Integer. Design time only.
selectedIndex()	The number of the last selected item. If multiple selections, an array is returned. Runtime only.
selectedItem()	The item name of the last selected item. If multiple selections, an array is returned. Runtime only.
selectedValue()	The value of the last selected item. If multiple selections, an array is returned. Runtime only.
setIndex(n)	Sets the current selection.The top item is 0. Runtime only.
text	The text of the current selection. Same as selectedItem().
values	An optional list of values associated with each item. Design time only.

Events

Standard events are supported.

Example

Function Select_jqm1_onchange()
  MsgBox "Selected: " & Select_jqm1.selectedItem()
End Function

Output

(message box showing “Selected: 2”)

Select popup with nativeMenu set to false:

Select popup with nativeMenu set to true on iOS: