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 more information about how to write an app widget provider, read the App Widgets developer guide.
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Constructor to initialize AppWidgetProvider.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Called in response to the
ACTION_APPWIDGET_OPTIONS_CHANGED
broadcast when this widget has been layed out at a new size.
| |||||||||||
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_OPTIONS_CHANGED
broadcast when this widget has been layed out at a new size.
context | The Context in which this receiver is
running. |
---|---|
appWidgetManager | A AppWidgetManager object you can call updateAppWidget(ComponentName, RemoteViews) on. |
appWidgetId | The appWidgetId of the widget who's size changed. |
newOptions | The appWidgetId of the widget who's size changed. |
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. |