Android.Appwidget Namespace

Contains the components necessary to create "app widgets", which users can embed in other applications (such as the home screen) to quickly access application data and services without launching a new activity.

Remarks

Contains the components necessary to create "app widgets", which users can embed in other applications (such as the home screen) to quickly access application data and services without launching a new activity.

For more information, see the App Widgets guide.

The behavior of an app widget is published by an "app widget provider." An "app widget host" is a component that can contain app widgets (such as the Home screen).

Any application can publish app widgets (as an app widget provider). All an application needs to do to publish an app widget is provide a Android.Content.BroadcastReceiver that receives the Android.Appwidget.AppWidgetManager.ActionAppwidgetUpdate intent and provide some metadata about the app widget. Android provides the Android.Appwidget.AppWidgetProvider class, which extends Android.Content.BroadcastReceiver, as a convenience class to define the app widget behavrio and aid in handling the broadcasts.

App widget hosts are the containers in which widgets can be placed. Most of the look and feel details are left up to the widget hosts. For example, the home screen has one way of viewing widgets, but the lock screen could also contain widgets, and it would have a different way of adding, removing and otherwise managing widgets.

For information about implementing an app widget host, see the Android.Appwidget.AppWidgetHost class.

Classes

TypeReason
AppWidgetCategoryEnumerates values returned by several types.
AppWidgetHostAppWidgetHost provides the interaction with the AppWidget service for apps, like the home screen, that want to embed AppWidgets in their UI.
AppWidgetHostViewProvides the glue to show AppWidget views.
AppWidgetManagerUpdates AppWidget state; gets information about installed AppWidget providers and other AppWidget related state.
AppWidgetProviderA convenience class to aid in implementing an AppWidget provider.
AppWidgetProviderInfoDescribes the meta data for an installed AppWidget provider.
AppWidgetProviderInfo+InterfaceConstsDocumentation for this section has not yet been entered.
ResizeModeEnumerates values returned by several types.