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. |