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. |