Controls

Building blocks for creating Xamarin.Android User Interfaces

PDF for offline use

Let us know how you feel about this

Translation Quality


0/250

last updated: 2017-08

Xamarin.Android exposes all of the native user interface controls (widgets) provided by Android. These controls can be easily added to Xamarin.Android apps using the Android Designer or programatically via XML layout files. Regardless of which method you choose, Xamarin.Android exposes all of the user interface object properties and methods in C#. The following sections introduce the most common Android user interface controls and explain how to incorporate them into Xamarin.Android apps.

Action Bar

ActionBar is a toolbar that displays the activity title, navigation interfaces, and other interactive items. Typically, the action bar appears at the top of an activity's window.

Example ActionBar

Auto Complete

AutoCompleteTextView is an editable text view element that shows completion suggestions automatically while the user is typing. The list of suggestions is displayed in a drop down menu from which the user can choose an item to replace the content of the edit box with.

Example of Auto Complete

Buttons

Buttons are UI elements that the user taps to perform an action.

Example Buttons

Calendar

The Calendar class is used for converting a specific instance in time (a millisecond value that is offset from the epoch) to values such as year, month, hour, day of the month, and the date of the next week. Calendar supports a wealth of interaction options with calendar data, including the ability to read and write events, attendees, and reminders. By using the calendar provider in your application, data you add through the API will appear in the built-in calendar app that comes with Android.

Example Calendar

CardView

CardView is a UI component that presents text and image content in views that resemble cards. CardView is implemented as a FrameLayout widget with rounded corners and a shadow. Typically, a CardView is used to present a single row item in a ListView or GridView view group.

Example Card View

Edit Text

EditText is a UI element that is used for entering and modifying text.

Example Edit Text

Gallery

Gallery is a layout widget that is used to display items in a horizontally scrolling list; it positions the current selection at the center of the view.

Example Gallery

Navigation Bar

The Navigation Bar provides navigation controls on devices that do not include hardware buttons for Home, Back, and Menu.

Example Navigation Bar

Pickers

Pickers are UI elements that allow the user to pick a date or a time using dialogs that are provided by Android.

Example Picker

Popup Menu

PopupMenu is used for displaying popup menus that are attached to a particular view.

Example PopUp Menu

Spinner

Spinner is a UI element that provides a quick way to select one value from a set. It is simmilar to a drop-down list.

Example Spinner

Switch

Switch is a UI element that allows a user to toggle between two states, such as ON or OFF. The Switch default value is OFF.

Example Switch

TextureView

TextureView is a view that uses hardware-accelerated 2D rendering to enable a video or OpenGL content stream to be displayed.

Example Texture View

ToolBar

The Toolbar widget (introduced in Android 5.0 Lollipop) can be thought of as a generalization of the action bar interface – it is intended to replace the action bar. The Toolbar can be used anywhere in an app layout, and it is much more customizable than an action bar.

Example Toolbar

ViewPager

The ViewPager is a layout manager that allows the user to flip left and right through pages of data.

Example ViewPager

WebView

WebView is a UI element that allows you to create your own window for viewing web pages (or even develop a complete browser).

Example Web View

Xamarin Workbook

If it's not already installed, install the Xamarin Workbooks app first. The workbook file should download automatically, but if it doesn't, just click to start the workbook download manually.