android.widget

小部件包中包含（大部分是可视化的）用户界面元素，可用于您的应用程 你也可以设计你自己的。

要创建自己的小部件，请扩展View或其子类。 要在布局XML中使用您的小部件，您需要创建两个附加文件。 以下是您需要为实现自定义小部件而创建的文件列表：

• Java implementation file - This is the file that implements the behavior of the widget. If you can instantiate the object from layout XML, you will also have to code a constructor that retrieves all the attribute values from the layout XML file.
• XML definition file - An XML file in res/values/ that defines the XML element used to instantiate your widget, and the attributes that it supports. Other applications will use this element and attributes in their in another in their layout XML.
• Layout XML [optional]- An optional XML file inside res/layout/ that describes the layout of your widget. You could also do this in code in your Java file.

ApiDemos示例应用程序有一个创建自定义布局XML标签LabelView的示例。 请参阅下列演示实现和使用自定义小部件的文件：

• LabelView.java - The implementation file
• res/values/attrs.xml - Definition file
• res/layout/custom_view_1.xml - Layout file

Annotations

RemoteViews.RemoteView

这个注解表明View的一个子类被用于 RemoteViews机制。

Interfaces

AbsListView.MultiChoiceModeListener	一个MultiChoiceModeListener接收事件 CHOICE_MODE_MULTIPLE_MODAL 。
AbsListView.OnScrollListener	滚动列表或网格时要调用的回调的接口定义。
AbsListView.RecyclerListener	RecyclerListener用于在View中放入RecycleBin的废料堆内时接收通知。
AbsListView.SelectionBoundsAdjuster	列表项的顶层视图可以实现此接口，以允许自己修改为该项显示的选择范围。
ActionMenuView.OnMenuItemClickListener	如果项目本身没有单独的项目点击监听器，则负责接收菜单项点击事件。
Adapter	适配器对象充当 AdapterView与该视图的基础数据之间的桥梁。
AdapterView.OnItemClickListener	在单击此AdapterView中的项目时调用回调的接口定义。
AdapterView.OnItemLongClickListener	在单击并保持此视图中的项目时调用回调的接口定义。
AdapterView.OnItemSelectedListener	在此视图中的项目被选中时调用回调的接口定义。
Advanceable	这个接口可以通过任何集合类型的视图来实现，这个视图具有通过其子集进行概念的概念。
AutoCompleteTextView.OnDismissListener	监听器响应AutoCompleteTextView的完成列表被解散。
AutoCompleteTextView.Validator	该接口用于确保在此TextView中输入的文本符合特定的格式。
CalendarView.OnDateChangeListener	用于指示用户更改日期的回调。
Checkable	定义使它们可检查的视图的扩展。
Chronometer.OnChronometerTickListener	一个回调，通知天文钟自己增加的时间。
CompoundButton.OnCheckedChangeListener	在复合按钮的选中状态改变时调用回调的接口定义。
DatePicker.OnDateChangedListener	用于指示用户更改日期的回调。
ExpandableListAdapter	将 ExpandableListView与底层数据链接的适配器。
ExpandableListView.OnChildClickListener	当此可扩展列表中的某个子项被点击时，将调用回调的接口定义。
ExpandableListView.OnGroupClickListener	当此可扩展列表中的组已被点击时，将调用回调的接口定义。
ExpandableListView.OnGroupCollapseListener	用于在组崩溃时收到通知
ExpandableListView.OnGroupExpandListener	用于在组展开时收到通知
Filter.FilterListener	监听器用于在完成过滤操作后收到通知。
Filterable	定义可过滤的行为。
FilterQueryProvider	CursorAdapter和CursorTreeAdapter的外部客户端可以使用此类来定义如何过滤适配器的内容。
HeterogeneousExpandableList	实施时的其他方法使 ExpandableListAdapter利用 Adapter视图类型机制。
ListAdapter	扩展 Adapter ，这是 ListView和支持列表的数据之间的桥梁。
MediaController.MediaPlayerControl
MultiAutoCompleteTextView.Tokenizer
NumberPicker.Formatter	用于将当前值格式化为用于演示的字符串的接口。
NumberPicker.OnScrollListener	用于侦听拾取器滚动状态的界面。
NumberPicker.OnValueChangeListener	接口监听当前值的变化。
PopupMenu.OnDismissListener	用于通知应用程序菜单已关闭的回调界面。
PopupMenu.OnMenuItemClickListener	如果项目本身没有单独的项目点击监听器，则负责接收菜单项点击事件。
PopupWindow.OnDismissListener	当这个弹出窗口被解除时被调用的监听器。
RadioGroup.OnCheckedChangeListener	在此组中选中的单选按钮发生变化时要调用回调的接口定义。
RatingBar.OnRatingBarChangeListener	当评级已更改时通知客户的回调。
RemoteViewsService.RemoteViewsFactory	远程集合视图（ListView，GridView等）与该视图的基础数据之间的适配器接口。
SearchView.OnCloseListener
SearchView.OnQueryTextListener	对查询文本进行更改的回调。
SearchView.OnSuggestionListener	建议选择事件的回调界面。
SectionIndexer	可上实现接口 Adapter s至启用的部分之间快速滚动 AbsListView 。
SeekBar.OnSeekBarChangeListener	当进程级别发生变化时通知客户端的回调。
ShareActionProvider.OnShareTargetSelectedListener	听众选择股票目标的事件。
SimpleAdapter.ViewBinder	SimpleAdapter的外部客户端可以使用此类将值绑定到视图。
SimpleCursorAdapter.CursorToStringConverter	SimpleCursorAdapter的外部客户端可以使用此类来定义Cursor应该如何转换为字符串。
SimpleCursorAdapter.ViewBinder	SimpleCursorAdapter的外部客户端可以使用此类将Cursor的值绑定到视图。
SimpleCursorTreeAdapter.ViewBinder	SimpleCursorTreeAdapter的外部客户端可以使用此类将Cursor中的值绑定到视图。
SlidingDrawer.OnDrawerCloseListener	当抽屉关闭时调用回调。
SlidingDrawer.OnDrawerOpenListener	当抽屉打开时调用回调。
SlidingDrawer.OnDrawerScrollListener	当抽屉滚动时调用回调。
SpinnerAdapter	扩展 Adapter ，这是 Spinner及其数据之间的桥梁。
TabHost.OnTabChangeListener	当选项卡更改时要调用的回调的接口定义
TabHost.TabContentFactory	选中时制作选项卡的内容。
TextView.OnEditorActionListener	在编辑器上执行操作时调用回调的接口定义。
ThemedSpinnerAdapter	SpinnerAdapter的一个扩展，它能够将下拉视图与正常视图的不同主题进行充气。
TimePicker.OnTimeChangedListener	用于指示时间的回调界面已被调整。
Toolbar.OnMenuItemClickListener	如果项目本身没有单独的项目点击监听器，则负责接收菜单项点击事件。
ViewSwitcher.ViewFactory	在ViewSwitcher中创建视图。
WrapperListAdapter	包含另一个列表适配器的列表适配器。
ZoomButtonsController.OnZoomListener	将在用户执行触发某些操作的交互（例如缩放）时调用的接口。

Classes

AbsListView	可用于实现项目虚拟化列表的基类。
AbsListView.LayoutParams	AbsListView扩展了LayoutParams以提供一个位置来保存视图类型。
AbsoluteLayout	此类已在API级别3中弃用。请FrameLayout使用RelativeLayout或自定义布局。
AbsoluteLayout.LayoutParams	与AbsoluteLayout关联的每个子布局信息。
AbsSeekBar
AbsSpinner	Spinner窗口小部件的抽象基类。
ActionMenuView	ActionMenuView是一系列作为视图的菜单选项的演示文稿。
ActionMenuView.LayoutParams
AdapterView<T extends Adapter>	AdapterView是一个视图，子视图由 Adapter决定。
AdapterView.AdapterContextMenuInfo	onCreateContextMenu(ContextMenu, View, ContextMenuInfo)提供上下文菜单时，为 onCreateContextMenu(ContextMenu, View, ContextMenuInfo)回调提供的额外菜单信息。
AdapterViewAnimator	AdapterView基类，在切换视图时将执行动画。
AdapterViewFlipper	简单的 ViewAnimator将在已添加到两个或更多视图之间进行动画处理。
AlphabetIndexer	实现SectionIndexer接口的适配器的辅助类。
AnalogClock	此类已在API级别23中弃用。此小组件不再受支持。
ArrayAdapter<T>	具有任意对象数组支持的具体BaseAdapter。
AutoCompleteTextView	一个可编辑的文本视图，在用户输入时自动显示完成建议。
BaseAdapter	可以在 ListView （通过实现专门的 ListAdapter接口）和 Spinner （通过实现专门的 SpinnerAdapter接口）中使用的 Adapter公共基类。
BaseExpandableListAdapter	用于从某些数据向可扩展列表视图提供数据和视图的 ExpandableListAdapter基类。
Button	代表一个按钮小部件。
CalendarView	此课程是用于显示和选择日期的日历小部件。
CheckBox	复选框是一种特定类型的双态按钮，可以选中或不选中。
CheckedTextView	TextView的扩展，支持 Checkable接口和显示。
Chronometer	实现简单定时器的类。
CompoundButton	有两种状态的按钮，选中并取消选中。
CursorAdapter	将数据从 Cursor暴露给 ListView小部件的适配器。
CursorTreeAdapter	将一系列 Cursor的数据公开到 ExpandableListView小部件的 ExpandableListView 。
DatePicker	提供选择日期的小部件。
DialerFilter
DigitalClock	此类已在API级别17中弃用。建议您改用TextClock 。
EdgeEffect	当用户滚动超过2D空间中的内容边界时，此类执行可滚动窗口小部件边缘处使用的图形效果。
EditText	EditText是TextView上的一个薄板，可以将其自身配置为可编辑。
ExpandableListView	显示垂直滚动两级列表中的项目的视图。
ExpandableListView.ExpandableListContextMenuInfo	ExpandableListView提供上下文菜单时，为 onCreateContextMenu(ContextMenu, View, ContextMenuInfo)回调提供的特定于 ExpandableListView额外菜单信息。
Filter	过滤器使用过滤模式来限制数据。
Filter.FilterResults	保存过滤操作的结果。
FrameLayout	FrameLayout旨在阻挡屏幕上的某个区域以显示单个项目。
FrameLayout.LayoutParams	支持边距的布局的每个子布局信息。
Gallery	此类已在API级别16中弃用。此小组件不再受支持。 其他水平滚动窗口小部件包括来自支持库的HorizontalScrollView和ViewPager 。
Gallery.LayoutParams	Gallery扩展了LayoutParams以提供一个位置来保存当前转换信息以及之前的位置/转换信息。
GridLayout	将子项放置在矩形 网格中的布局。
GridLayout.Alignment	对齐方式指定视图应放置在单元格组中的位置以及其大小。
GridLayout.LayoutParams	布局信息与GridLayout的每个子节点相关联。
GridLayout.Spec	Spec规定了一组单元的水平或垂直特性。
GridView	显示二维滚动网格中的项目的视图。
HeaderViewListAdapter	当ListView具有标题视图时使用ListAdapter。
HorizontalScrollView	用于视图层次结构的布局容器，可以由用户滚动，允许它比物理显示更大。
ImageButton	显示带有可由用户按下或点击的图像（而不是文本）的按钮。
ImageSwitcher
ImageView	显示任意图像，如图标。
LinearLayout	将其子项排列在单列或单行中的布局。
LinearLayout.LayoutParams	与ViewLinearLayout相关联的每个孩子的布局信息。
ListPopupWindow	ListPopupWindow将自己锚定到主机视图并显示选项列表。
ListView	显示垂直滚动列表中的项目的视图。
ListView.FixedViewInfo	表示列表中固定视图的类，例如顶部的标题或底部的页脚。
MediaController	包含MediaPlayer控件的视图。
MultiAutoCompleteTextView	一个可编辑的文本视图，扩展 AutoCompleteTextView ，它可以显示用户输入的文本的子字符串的完成建议，而不是整个事物的完整建议。
MultiAutoCompleteTextView.CommaTokenizer	这个简单的Tokenizer可以用于用逗号和一个或多个空格分隔项目的列表。
NumberPicker	一个小部件，使用户能够从预定义的范围中选择一个数字。
OverScroller	这个类封装了滚动功能，可以超越滚动操作的范围。
PopupMenu	甲PopupMenu的显示 Menu在锚定到一个模式弹出窗口 View 。
PopupWindow	这个类表示一个可用于显示任意视图的弹出窗口。
ProgressBar	某些操作的进度的可视化指标。
QuickContactBadge	使用标准QuickContact徽章和点击行为显示图片的小部件。
RadioButton	单选按钮是一个可以选中或不选中的双状态按钮。
RadioGroup	该类用于为一组单选按钮创建多个排除范围。
RadioGroup.LayoutParams	当这些布局参数在XML文件中未指定时，它们将默认宽度和高度为WRAP_CONTENT 。
RatingBar	RatingBar是SeekBar和ProgressBar的扩展，显示星星的评分。
RelativeLayout	一个布局，其中的孩子的位置可以描述为相互之间或父母。
RelativeLayout.LayoutParams	与RelativeLayout相关联的每个孩子的布局信息。
RemoteViews	描述可以在另一个进程中显示的视图层次结构的类。
RemoteViewsService	要连接到远程适配器以请求RemoteView的服务。
ResourceCursorAdapter	一个简单的适配器，用于创建在XML文件中定义的视图。
ResourceCursorTreeAdapter	一个相当简单的ExpandableListAdapter，用于创建在XML文件中定义的视图。
Scroller	这个类封装了滚动。
ScrollView	用于视图层次结构的布局容器，可以由用户滚动，允许它比物理显示更大。
SearchView	为用户提供用户界面的小部件，用于输入搜索查询并向搜索提供者提交请求。
SeekBar	SeekBar是ProgressBar的扩展，增加了一个可拖动的拇指。
ShareActionProvider	这是分享行动的提供者。
SimpleAdapter	一个简单的适配器，可将静态数据映射到XML文件中定义的视图。
SimpleCursorAdapter	一个简单的适配器，可将游标中的列映射到XML文件中定义的TextView或ImageView。
SimpleCursorTreeAdapter	一个简单的适配器，可将游标中的列映射到XML文件中定义的TextView或ImageView。
SimpleExpandableListAdapter	一个简单的适配器，可将静态数据映射到XML文件中定义的组和子视图。
SlidingDrawer	此类已在API级别17中弃用。此类不再受支持。 如果您必须在您的应用程序中使用它，建议您将自己的实现基于Android开放源代码项目的源代码。
Space	空间是一个轻量级的View子类，可用于在通用布局中的组件之间创建间隙。
Spinner	一次显示一个孩子并让用户从中选择一个孩子的视图。
StackView
Switch	Switch是一个双态切换开关小部件，可以在两个选项中进行选择。
TabHost	选项卡式窗口视图的容器。
TabHost.TabSpec	选项卡包含选项卡指示符，内容和用于跟踪它的标记。
TableLayout	将其子项排列成行和列的布局。
TableLayout.LayoutParams	这组布局参数强制每个孩子的宽度为MATCH_PARENT ，每个孩子的高度为WRAP_CONTENT ，但只限于未指定高度。
TableRow	水平排列其子项的布局。
TableRow.LayoutParams	表格行中使用的布局参数集。
TabWidget	显示表示父级选项卡集合中每个页面的选项卡标签列表。
TextClock	TextClock可以将当前日期和/或时间显示为格式化的字符串。
TextSwitcher	专门 ViewSwitcher ，只包含 TextView类型的 TextView 。
TextView	向用户显示文本，并可以选择允许他们编辑它。
TextView.SavedState	由TextView存储的用于实现 onSaveInstanceState()用户界面状态。
TimePicker	用于选择24小时或AM / PM模式中的时间的小部件。
Toast	吐司是一个包含用户快速消息的视图。 吐司类可以帮助您创建和显示这些。
ToggleButton	显示选中/未选中状态作为带有“指示灯”指示灯的按钮，默认情况下显示文字“开”或“关”。
Toolbar	用于应用程序内容的标准工具栏。
Toolbar.LayoutParams	工具栏的子视图的布局信息。
TwoLineListItem	此类在API级别17中已弃用。此类可由使用RelativeLayout或LinearLayout应用轻松实现。
VideoView	显示一个视频文件。
ViewAnimator	FrameLayout容器的基类，它将在视图之间切换时执行动画。
ViewFlipper	简单的 ViewAnimator ，将在两个或更多视图之间添加动画。
ViewSwitcher	ViewAnimator在两个视图之间切换，并有一个从中创建这些视图的工厂。
ZoomButton
ZoomButtonsController	ZoomButtonsController手柄显示和隐藏缩放控件并将其相对于所有者视图进行定位。
ZoomControls	ZoomControls类显示一组简单的控件，用于缩放并提供回调以注册事件。

Enums

ImageView.ScaleType	将图像边界缩放到此视图边界的选项。
TextView.BufferType

Exceptions

RemoteViews.ActionException

执行某个操作时发生错误时发送的例外情况