1page.title=Input Controls
2parent.title=User Interface
3parent.link=index.html
4@jd:body
5
6<div class="figure" style="margin:0">
7  <img src="{@docRoot}images/ui/ui-controls.png" alt="" style="margin:0" />
8</div>
9
10<p>Input controls are the interactive components in your app's user interface. Android provides a
11wide variety of controls you can use in your UI, such as buttons, text fields, seek bars,
12checkboxes, zoom buttons, toggle buttons, and many more.</p>
13
14<p>Adding an input control to your UI is as simple as adding an XML element to your <a
15href="{@docRoot}guide/topics/ui/declaring-layout.html">XML layout</a>. For example, here's a
16layout with a text field and button:</p>
17
18<pre style="clear:right">
19&lt;?xml version="1.0" encoding="utf-8"?>
20&lt;LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
21    android:layout_width="fill_parent"
22    android:layout_height="fill_parent"
23    android:orientation="horizontal">
24    &lt;EditText android:id="@+id/edit_message"
25        android:layout_weight="1"
26        android:layout_width="0dp"
27        android:layout_height="wrap_content"
28        android:hint="@string/edit_message" />
29    &lt;Button android:id="@+id/button_send"
30        android:layout_width="wrap_content"
31        android:layout_height="wrap_content"
32        android:text="@string/button_send"
33        android:onClick="sendMessage" />
34&lt;/LinearLayout>
35</pre>
36
37<p>Each input control supports a specific set of input events so you can handle events such as when
38the user enters text or touches a button.</p>
39
40
41<h2 id="CommonControls">Common Controls</h2>
42<p>Here's a list of some common controls that you can use in your app. Follow the links to learn
43more about using each one.</p>
44
45<p class="note"><strong>Note:</strong> Android provides several more controls than are listed
46here. Browse the {@link android.widget} package to discover more. If your app requires a
47specific kind of input control, you can build your own <a
48href="{@docRoot}guide/topics/ui/custom-components.html">custom components</a>.</p>
49
50<table>
51    <tr>
52        <th scope="col">Control Type</th>
53        <th scope="col">Description</th>
54	<th scope="col">Related Classes</th>
55    </tr>
56    <tr>
57        <td><a href="controls/button.html">Button</a></td>
58        <td>A push-button that can be pressed, or clicked, by the user to perform an action.</td>
59	<td>{@link android.widget.Button Button} </td>
60    </tr>
61    <tr>
62        <td><a href="controls/text.html">Text field</a></td>
63        <td>An editable text field. You can use the <code>AutoCompleteTextView</code> widget to create a text entry widget that provides auto-complete suggestions</td>
64	<td>{@link android.widget.EditText EditText}, {@link android.widget.AutoCompleteTextView}</td>
65    </tr>
66    <tr>
67        <td><a href="controls/checkbox.html">Checkbox</a></td>
68        <td>An on/off switch that can be toggled by the user. You should use checkboxes when presenting users with a group of selectable options that are not mutually exclusive.</td>
69	<td>{@link android.widget.CheckBox CheckBox} </td>
70    </tr>
71    <tr>
72        <td><a href="controls/radiobutton.html">Radio button</a></td>
73        <td>Similar to checkboxes, except that only one option can be selected in the group.</td>
74	<td>{@link android.widget.RadioGroup RadioGroup}
75	<br>{@link android.widget.RadioButton RadioButton} </td>
76    </tr>
77    <tr>
78        <td><a href="controls/togglebutton.html" style="white-space:nowrap">Toggle button</a></td>
79        <td>An on/off button with a light indicator.</td>
80	<td>{@link android.widget.ToggleButton ToggleButton} </td>
81    </tr>
82    <tr>
83        <td><a href="controls/spinner.html">Spinner</a></td>
84        <td>A drop-down list that allows users to select one value from a set.</td>
85	<td>{@link android.widget.Spinner Spinner} </td>
86    </tr>
87    <tr>
88        <td><a href="controls/pickers.html">Pickers</a></td>
89        <td>A dialog for users to select a single value for a set by using up/down buttons or via a swipe gesture. Use a <code>DatePicker</code>code> widget to enter the values for the date (month, day, year) or a <code>TimePicker</code> widget to enter the values for a time (hour, minute, AM/PM), which will be formatted automatically for the user's locale.</td>
90	<td>{@link android.widget.DatePicker}, {@link android.widget.TimePicker}</td>
91    </tr>
92</table>
93