A2v10 Platform documentation
UK


ComboBox Control

Represents a drop-down selection list.

Inherits: ValuedControl : Control : UIElement : UIElementBase

Content property: Children

Properties

Name Type Description
Children List<ComboBoxItems> List content. Represents a list of the ComboBoxItem items. Can be static or dynamic. Can be static or dynamic.
ItemsSource Array Always a binding - Bind. The data source to display in the list.
DisplayProperty String Name of the property to be displayed when linking list items to objects.
ShowValue Boolean Display value instead of content in the list.
Align TextAlign Text alignment.
Style ComboBoxStyle Display style. Possible values:
  • Default - (by default) a regular list.
  • Hyperlink - display the list as a hyperlink.
Size ControlSize Item size. Possible values:
  • Default - (by default) regular list size.
  • Large - increased list size.
(other values of the ControlSize enumeration are not supported).
Base item properties

Description

The content of the dropdown list can be determined in three different ways:

  • Static content.. In this case, the item must include a list of ComboBoxItem, items, for each of which the Content and Value properties are set. The ItemsSource property is not specified. When you select an item, the Value property is assigned the corresponding Value from the item. The list displays the Content property (or Value, if it is set that ShowValue = true).
  • Binding to the list of objects. In this case, the ItemsSource binding is associated with an array of objects. The value will be the selected object. The list displays the property of the associated object, specified by the DisplayProperty property.
  • Binding to a list of objects and value . In this case, the ItemsSource binding is also associated with an array of objects. But a single nested ComboBoxItemelement is used to display and select values. The Content and Value properties of this element are bound to the required values of the array element.