Represents a selection control with a drop-down list that allows users to select an item.

Remarks

ComboBox Items do not support icons or images on iOS. On iOS you can only display text.

Properties

Property Type Description
Background Color The background color of the control.
Border Color The color of the control's border.
BorderThickness Float The width of the control's border.
CornerRadius Integer The radius for the corners of the control's border.
Foreground Color The color of the control's content.
ItemBackground Color The background color of items.
ItemForeground Color The foreground color of items.
SelectedItemBackground Color The background color of the selected item.
SelectedItemForeground Color The foreground color of the selected item.
IconPosition Enum The position of the icon relative to the text. Possible values are Left, Right, & Top.
IconSize Float The size of the icon in dp pixels.
IconSpacing Float The spacing between the icon and text.
ShowAsMonochrome Boolean A value that indicates whether the Foreground color is applied to the icon.
FontSize Float The size of the text in dp pixels.
FontStyle Enum The style in which the text is rendered. Possible values are Normal & Italic.
FontWeight Enum The thickness of the specified font. Possible values are Thin, Light, Normal, Medium, Bold, Black
IconMemberPath String The name or path of the icon property that is displayed for each data item. Only applicable when ItemsSource bindings are used.
Items Array The collection used to generate the content of the control.
ItemsSource Binding A binding to a JavaScript or JSON array.
SelectedValue Object The value of the selected item.
SelectedValuePath String The property path that is bound to the SelectedValue property. Only applicable when ItemsSource bindings are used.
TextMemberPath String The name or path of the text property that is displayed for each data item. Only applicable when ItemsSource bindings are used.
ItemHeight Float The height of the layout area for each item.
ItemPadding Thickness The amount of space between the content of the item and its border.
Height Float The suggested height of the control in dp pixels.
HorizontalAlignment Enum The horizontal alignment characteristics that are applied to the control when it is composed in a parent layout panel, such as a Grid.
HorizontalContentAlignment Enum The horizontal alignment of the control's content.
Margin Thickness The outer margin that is applied to the control when it is composed in a parent layout panel, such as a Grid.
Padding Thickness The amount of space between the content of the control and its border.
Rotation Integer The rotation about the Z-axis in degrees.
VerticalAlignment Enum The vertical alignment characteristics that are applied to the control when it is composed in a parent layout panel, such as a Grid.
VerticalContentAlignment Enum The vertical alignment of the control's content.
Width Float The suggested width of the control in dp pixels.
IsEnabled Boolean A value that indicates whether the user can interact with the control.
IsHitTestVisible Boolean A value that indicates whether the contained area of the control can return true values for hit testing.
IsVisible Boolean A value that indicates whether the control should be visible.
Opacity Float A value between 0 and 1.0 that declares the opacity factor, with 1.0 meaning full opacity and 0 meaning transparent.

Events

Event Description
Loaded Occurs when the element is laid out, rendered, and ready for interaction.
Unloaded Occurs when the element is no longer rendered on the screen.
SelectionChanged Occurs when the currently selected item changes.

Item Properties

Property Type Description
Icon Icon The icon for the item.
Text String A string that specifies the text contents of the item.
Value String The value bound to the parent ComboBox's SelectedValue when this item is selected.
IsSelected Boolean A value that indicates whether the item is currently selected.