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
|
|||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
![]() |
|||||||||||
![]() |
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. |