# Media Browser Control

Represents a control that navigates collections of media files, playlists, & folders.

## Remarks

This control was designed to work specifically with Device objects that support the `MediaBrowser` capability. If your Device does not support that capability, you will not be able to use this control.

## 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`                                   |
| `ItemsSource`           | Binding   | A binding to a device object's `MediaBrowser` capability.                                                                                     |
| `Columns`                | Integer   | The number of columns that are in the grid. When -1 the property is ignored & will automatically allocate columns based on control & item sizes. |
| `HorizontalSpacing`      | Float     | The amount of separation between columns.                                                                                                       |
| `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.                                                                             |
| `ItemWidth`             | Float     | The width of the layout area for each item. When set to -1 the item will span the entire control width.                                        |
| `VerticalSpacing`        | Float     | The amount of separation between rows.                                                                                                          |
| `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.