Android 2.3 Gingerbread

Package android.widget

The widget package contains (mostly visual) UI elements to use on your Application screen.

See:
          Description

Interface Summary
AbsListView.OnScrollListener Interface definition for a callback to be invoked when the list or grid has been scrolled.
AbsListView.RecyclerListener A RecyclerListener is used to receive a notification whenever a View is placed inside the RecycleBin's scrap heap.
Adapter An Adapter object acts as a bridge between an AdapterView and the underlying data for that view.
AdapterView.OnItemClickListener Interface definition for a callback to be invoked when an item in this AdapterView has been clicked.
AdapterView.OnItemLongClickListener Interface definition for a callback to be invoked when an item in this view has been clicked and held.
AdapterView.OnItemSelectedListener Interface definition for a callback to be invoked when an item in this view has been selected.
AutoCompleteTextView.Validator This interface is used to make sure that the text entered in this TextView complies to a certain format.
Checkable Defines an extension for views that make them checkable.
Chronometer.OnChronometerTickListener A callback that notifies when the chronometer has incremented on its own.
CompoundButton.OnCheckedChangeListener Interface definition for a callback to be invoked when the checked state of a compound button changed.
CursorFilter.CursorFilterClient  
DatePicker.OnDateChangedListener The callback used to indicate the user changes the date.
DoubleDigitManager.CallBack The callback to indicate what is going on with the digits pressed.
ExpandableListAdapter An adapter that links a ExpandableListView with the underlying data.
ExpandableListView.OnChildClickListener Interface definition for a callback to be invoked when a child in this expandable list has been clicked.
ExpandableListView.OnGroupClickListener Interface definition for a callback to be invoked when a group in this expandable list has been clicked.
ExpandableListView.OnGroupCollapseListener Used for being notified when a group is collapsed
ExpandableListView.OnGroupExpandListener Used for being notified when a group is expanded
Filter.Delayer  
Filter.FilterListener Listener used to receive a notification upon completion of a filtering operation.
Filterable Defines a filterable behavior.
FilterQueryProvider This class can be used by external clients of CursorAdapter and CursorTreeAdapter to define how the content of the adapter should be filtered.
HeterogeneousExpandableList Additional methods that when implemented make an ExpandableListAdapter take advantage of the Adapter view type mechanism.
ListAdapter Extended Adapter that is the bridge between a ListView and the data that backs the list.
MediaController.MediaPlayerControl  
MultiAutoCompleteTextView.Tokenizer  
NumberPicker.Formatter Interface used to format the number into a string for presentation
NumberPicker.OnChangedListener The callback interface used to indicate the number value has been adjusted.
PopupWindow.OnDismissListener Listener that is called when this popup window is dismissed.
RadioGroup.OnCheckedChangeListener Interface definition for a callback to be invoked when the checked radio button changed in this group.
RatingBar.OnRatingBarChangeListener A callback that notifies clients when the rating has been changed.
SectionIndexer Interface that should be implemented on Adapters to enable fast scrolling in an AbsListView between sections of the list.
SeekBar.OnSeekBarChangeListener A callback that notifies clients when the progress level has been changed.
SimpleAdapter.ViewBinder This class can be used by external clients of SimpleAdapter to bind values to views.
SimpleCursorAdapter.CursorToStringConverter This class can be used by external clients of SimpleCursorAdapter to define how the Cursor should be converted to a String.
SimpleCursorAdapter.ViewBinder This class can be used by external clients of SimpleCursorAdapter to bind values fom the Cursor to views.
SimpleCursorTreeAdapter.ViewBinder This class can be used by external clients of SimpleCursorTreeAdapter to bind values from the Cursor to views.
SlidingDrawer.OnDrawerCloseListener Callback invoked when the drawer is closed.
SlidingDrawer.OnDrawerOpenListener Callback invoked when the drawer is opened.
SlidingDrawer.OnDrawerScrollListener Callback invoked when the drawer is scrolled.
SpinnerAdapter Extended Adapter that is the bridge between a Spinner and its data.
TabHost.OnTabChangeListener Interface definition for a callback to be invoked when tab changed
TabHost.TabContentFactory Makes the content of a tab when it is selected.
TabWidget.OnTabSelectionChanged Let TabHost know that the user clicked on a tab indicator.
TextView.OnEditorActionListener Interface definition for a callback to be invoked when an action is performed on the editor.
TimePicker.OnTimeChangedListener The callback interface used to indicate the time has been adjusted.
ViewSwitcher.ViewFactory Creates views in a ViewSwitcher.
WrapperListAdapter List adapter that wraps another list adapter.
ZoomButtonsController.OnZoomListener Interface that will be called when the user performs an interaction that triggers some action, for example zooming.
 

Class Summary
AbsListView Base class that can be used to implement virtualized lists of items.
AbsListView.LayoutParams AbsListView extends LayoutParams to provide a place to hold the view type.
AbsListView.SavedState  
AbsoluteLayout Deprecated. Use FrameLayout, RelativeLayout or a custom layout instead.
AbsoluteLayout.LayoutParams Per-child layout information associated with AbsoluteLayout.
AbsSeekBar  
AbsSpinner An abstract base class for spinner widgets.
AbsSpinner.SavedState  
AdapterView<T extends Adapter> An AdapterView is a view whose children are determined by an Adapter.
AdapterView.AdapterContextMenuInfo Extra menu information provided to the android.view.View.OnCreateContextMenuListener#onCreateContextMenu(ContextMenu, View, ContextMenuInfo) callback when a context menu is brought up for this AdapterView.
AlphabetIndexer A helper class for adapters that implement the SectionIndexer interface.
AnalogClock This widget display an analogic clock with two hands for hours and minutes.
AppSecurityPermissions This class contains the SecurityPermissions view implementation.
ArrayAdapter<T> A ListAdapter that manages a ListView backed by an array of arbitrary objects.
AutoCompleteTextView An editable text view that shows completion suggestions automatically while the user is typing.
BaseAdapter Common base class of common implementation for an Adapter that can be used in both ListView (by implementing the specialized ListAdapter interface} and Spinner (by implementing the specialized SpinnerAdapter interface.
BaseExpandableListAdapter Base class for a ExpandableListAdapter used to provide data and Views from some data to an expandable list view.
Button Represents a push-button widget.
CheckBox A checkbox is a specific type of two-states button that can be either checked or unchecked.
CheckedTextView An extension to TextView that supports the Checkable interface.
Chronometer Class that implements a simple timer.
CompoundButton A button with two states, checked and unchecked.
CompoundButton.SavedState  
CursorAdapter Adapter that exposes data from a Cursor to a ListView widget.
CursorFilter The CursorFilter delegates most of the work to the CursorAdapter.
CursorTreeAdapter An adapter that exposes data from a series of Cursors to an ExpandableListView widget.
DatePicker A view for selecting a month / year / day based on a calendar like layout.
DateTimeView Displays a given time in a convenient human-readable foramt.
DialerFilter  
DigitalClock Like AnalogClock, but digital.
DoubleDigitManager Provides callbacks indicating the steps in two digit pressing within a timeout.
EdgeGlow This class performs the glow effect used at the edges of scrollable widgets.
EditText EditText is a thin veneer over TextView that configures itself to be editable.
ExpandableListConnector A BaseAdapter that provides data/Views in an expandable list (offers features such as collapsing/expanding groups containing children).
ExpandableListConnector.GroupMetadata Metadata about an expanded group to help convert from a flat list position to either a) group position for groups, or b) child position for children
ExpandableListConnector.PositionMetadata Data type that contains an expandable list position (can refer to either a group or child) and some extra information regarding referred item (such as where to insert into the flat list, etc.)
ExpandableListPosition ExpandableListPosition can refer to either a group's position or a child's position.
ExpandableListView A view that shows items in a vertically scrolling two-level list.
ExpandableListView.ExpandableListContextMenuInfo Extra menu information specific to an ExpandableListView provided to the android.view.View.OnCreateContextMenuListener#onCreateContextMenu(ContextMenu, View, ContextMenuInfo) callback when a context menu is brought up for this AdapterView.
ExpandableListView.SavedState  
FastScroller Helper class for AbsListView to draw and control the Fast Scroll thumb
Filter A filter constrains data with a filtering pattern.
Filter.FilterResults Holds the results of a filtering operation.
FrameLayout FrameLayout is designed to block out an area on the screen to display a single item.
FrameLayout.LayoutParams Per-child layout information for layouts that support margins.
Gallery A view that shows items in a center-locked, horizontally scrolling list.
Gallery.LayoutParams Gallery extends LayoutParams to provide a place to hold current Transformation information along with previous position/transformation info.
GridView A view that shows items in two-dimensional scrolling grid.
HeaderViewListAdapter ListAdapter used when a ListView has header views.
HorizontalScrollView Layout container for a view hierarchy that can be scrolled by the user, allowing it to be larger than the physical display.
ImageButton Displays a button with an image (instead of text) that can be pressed or clicked by the user.
ImageSwitcher  
ImageView Displays an arbitrary image, such as an icon.
LinearLayout A Layout that arranges its children in a single column or a single row.
LinearLayout.LayoutParams Per-child layout information associated with ViewLinearLayout.
ListView A view that shows items in a vertically scrolling list.
ListView.SavedState  
MediaController A view containing controls for a MediaPlayer.
MultiAutoCompleteTextView An editable text view, extending AutoCompleteTextView, that can show completion suggestions for the substring of the text where the user is typing instead of necessarily for the entire thing.
MultiAutoCompleteTextView.CommaTokenizer This simple Tokenizer can be used for lists where the items are separated by a comma and one or more spaces.
NumberPicker A view for selecting a number For a dialog using this view, see TimePickerDialog.
NumberPickerButton This class exists purely to cancel long click events, that got started in NumberPicker
OverScroller This class encapsulates scrolling with the ability to overshoot the bounds of a scrolling operation.
OverScroller.MagneticOverScroller  
PopupWindow A popup window that can be used to display an arbitrary view.
ProgressBar Visual indicator of progress in some operation.
ProgressBar.SavedState  
QuickContactBadge Widget used to show an image with the standard QuickContact badge and on-click behavior.
RadioButton A radio button is a two-states button that can be either checked or unchecked.
RadioGroup This class is used to create a multiple-exclusion scope for a set of radio buttons.
RadioGroup.LayoutParams This set of layout parameters defaults the width and the height of the children to ViewGroup.LayoutParams.WRAP_CONTENT when they are not specified in the XML file.
RatingBar A RatingBar is an extension of SeekBar and ProgressBar that shows a rating in stars.
RelativeLayout A Layout where the positions of the children can be described in relation to each other or to the parent.
RelativeLayout.LayoutParams Per-child layout information associated with RelativeLayout.
RemoteViews A class that describes a view hierarchy that can be displayed in another process.
ResourceCursorAdapter An easy adapter that creates views defined in an XML file.
ResourceCursorTreeAdapter A fairly simple ExpandableListAdapter that creates views defined in an XML file.
ScrollBarDrawable This is only used by View for displaying its scroll bars.
Scroller This class encapsulates scrolling.
ScrollView Layout container for a view hierarchy that can be scrolled by the user, allowing it to be larger than the physical display.
SeekBar A SeekBar is an extension of ProgressBar that adds a draggable thumb.
SimpleAdapter An easy adapter to map static data to views defined in an XML file.
SimpleCursorAdapter An easy adapter to map columns from a cursor to TextViews or ImageViews defined in an XML file.
SimpleCursorTreeAdapter An easy adapter to map columns from a cursor to TextViews or ImageViews defined in an XML file.
SimpleExpandableListAdapter An easy adapter to map static data to group and child views defined in an XML file.
SlidingDrawer SlidingDrawer hides content out of the screen and allows the user to drag a handle to bring the content on screen.
Spinner A view that displays one child at a time and lets the user pick among them.
TabHost Container for a tabbed window view.
TableLayout A layout that arranges its children into rows and columns.
TableLayout.LayoutParams This set of layout parameters enforces the width of each child to be ViewGroup.LayoutParams.MATCH_PARENT and the height of each child to be ViewGroup.LayoutParams.WRAP_CONTENT, but only if the height is not specified.
TableRow A layout that arranges its children horizontally.
TableRow.LayoutParams Set of layout parameters used in table rows.
TabWidget Displays a list of tab labels representing each page in the parent's tab collection.
TextSwitcher Specialized ViewSwitcher that contains only children of type TextView.
TextView Displays text to the user and optionally allows them to edit it.
TextView.SavedState User interface state that is stored by TextView for implementing View.onSaveInstanceState().
TimePicker A view for selecting the time of day, in either 24 hour or AM/PM mode.
Toast A toast is a view containing a quick little message for the user.
ToggleButton Displays checked/unchecked states as a button with a "light" indicator and by default accompanied with the text "ON" or "OFF".
TwoLineListItem A view group with two children, intended for use in ListViews.
VideoView Displays a video file.
ViewAnimator Base class for a FrameLayout container that will perform animations when switching between its views.
ViewFlipper Simple ViewAnimator that will animate between two or more views that have been added to it.
ViewSwitcher ViewAnimator that switches between two views, and has a factory from which these views are created.
ZoomButton  
ZoomButtonsController The ZoomButtonsController handles showing and hiding the zoom controls and positioning it relative to an owner view.
ZoomControls The ZoomControls class displays a simple set of controls used for zooming and provides callbacks to register for events.
 

Enum Summary
ImageView.ScaleType Options for scaling the bounds of an image to the bounds of this view.
TextView.BufferType  
 

Exception Summary
RemoteViews.ActionException Exception to send when something goes wrong executing an action
 

Annotation Types Summary
RemoteViews.RemoteView This annotation indicates that a subclass of View is alllowed to be used with the RemoteViews mechanism.
 

Package android.widget Description

The widget package contains (mostly visual) UI elements to use on your Application screen. You can design your own

To create your own widget, extend View or a subclass. To use your widget in layout XML, there are two additional files for you to create. Here is a list of files you'll need to create to implement a custom widget:

ApiDemos sample application has an example of creating a custom layout XML tag, LabelView. See the following files that demonstrate implementing and using a custom widget:


Android 2.3 Gingerbread