Combo Box

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.