A control that allows users to make selections from provided choices. Supports search and multiple selections.

Description

A Combo box control allows you to search for items you will select. The search is performed server-side on the SearchField property so performance is not affected by very large data sources.

Single or multi-select mode is configured via the SelectMultiple property.

When searching for items to select, for each item you can choose to show a single data value, two values or a picture and two values (Person) by modifying the Layout setting in the Data pane.

Key properties

Items – The source of data from which selections can be made.

DefaultItems – The initial selected item(s) before the user interacts with the control.

SelectedItems – List of selected items resulting from user interaction.

SelectMultiple – Whether the user can select a single item or multiple items.

IsSearchable – Whether the user can search for items before selecting.

Additional properties

BorderColor – The color of a control's border.

BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness – The thickness of a control's border.

Default – The initial selection before it is changed by the user in single-select mode.

DisplayFields – List of fields shown for each item returned by the search. Easiest to configure via the Data pane in the Properties option tab.

DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

Height – The distance between a control's top and bottom edges.

InputTextPlaceholder – Instructional text shown to end-users when no items are selected.

OnChange – How the app responds when the user changes a selection.

OnNavigate – How the app responds when the user clicks on an item.

OnSelect – How the app responds when the user taps or clicks a control.

Visible – Whether a control appears or is hidden.

Width – The distance between a control's left and right edges.

X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

Example

  1. Add a Combo box control from the Insert tab, Controls menu.
  2. In the Properties options tab, click on Data.
  3. Select the data source, layout and related properties below.
  4. Set the SelectMultiple property in the Advanced tab.

    A functional Combo box will appear in your app.

    Don't know how to add and configure a control?.