| java.lang.Object | ||
| ↳ | android.content.BroadcastReceiver | |
| ↳ | android.appwidget.AppWidgetProvider | |
A convenience class to aid in implementing an AppWidget provider.
Everything you can do with AppWidgetProvider, you can do with a regular BroadcastReceiver.
AppWidgetProvider merely parses the relevant fields out of the Intent that is received in
onReceive(Context,Intent), and calls hook methods
with the received extras.
Extend this class and override one or more of the onUpdate(Context, AppWidgetManager, int[]), onDeleted(Context, int[]),
onEnabled(Context) or onDisabled(Context) methods to implement your own AppWidget functionality.
For an example of how to write a AppWidget provider, see the AppWidgets documentation.
| Public Constructors | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Constructor to initialize AppWidgetProvider.
| |||||||||||
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Called in response to the
ACTION_APPWIDGET_DELETED broadcast when
one or more AppWidget instances have been deleted. Override this method to implement
your own AppWidget functionality.
| |||||||||||
Called in response to the
ACTION_APPWIDGET_DISABLED broadcast, which
is sent when the last AppWidget instance for this provider is deleted. Override this method
to implement your own AppWidget functionality.
| |||||||||||
Called in response to the
ACTION_APPWIDGET_ENABLED broadcast when
the a AppWidget for this provider is instantiated. Override this method to implement your
own AppWidget functionality.
| |||||||||||
Implements
onReceive(Context, Intent) to dispatch calls to the various
other methods on AppWidgetProvider. | |||||||||||
Called in response to the
ACTION_APPWIDGET_UPDATE broadcast when
this AppWidget provider is being asked to provide RemoteViews
for a set of AppWidgets. Override this method to implement your own AppWidget functionality.
| |||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class android.content.BroadcastReceiver
| |||||||||||
From class java.lang.Object
| |||||||||||
Called in response to the ACTION_APPWIDGET_DELETED broadcast when
one or more AppWidget instances have been deleted. Override this method to implement
your own AppWidget functionality.
| context | The Context in which this receiver is
running. |
|---|---|
| appWidgetIds | The appWidgetIds that have been deleted from their host. |
Called in response to the ACTION_APPWIDGET_DISABLED broadcast, which
is sent when the last AppWidget instance for this provider is deleted. Override this method
to implement your own AppWidget functionality.
| context | The Context in which this receiver is
running. |
|---|
Called in response to the ACTION_APPWIDGET_ENABLED broadcast when
the a AppWidget for this provider is instantiated. Override this method to implement your
own AppWidget functionality.
When the last AppWidget for this provider is deleted,
ACTION_APPWIDGET_DISABLED is sent by the AppWidget manager, and
onDisabled(Context) is called. If after that, an AppWidget for this provider is created
again, onEnabled() will be called again.
| context | The Context in which this receiver is
running. |
|---|
Implements onReceive(Context, Intent) to dispatch calls to the various
other methods on AppWidgetProvider.
| context | The Context in which the receiver is running. |
|---|---|
| intent | The Intent being received. |
Called in response to the ACTION_APPWIDGET_UPDATE broadcast when
this AppWidget provider is being asked to provide RemoteViews
for a set of AppWidgets. Override this method to implement your own AppWidget functionality.
| context | The Context in which this receiver is
running. |
|---|---|
| appWidgetManager | A AppWidgetManager object you can call updateAppWidget(ComponentName, RemoteViews) on. |
| appWidgetIds | The appWidgetIds for which an update is needed. Note that this may be all of the AppWidget instances for this provider, or just a subset of them. |