Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
public class

AppWidgetHost

extends Object
java.lang.Object
   ↳ android.appwidget.AppWidgetHost

Class Overview

AppWidgetHost provides the interaction with the AppWidget service for apps, like the home screen, that want to embed AppWidgets in their UI.

Summary

Public Constructors
AppWidgetHost ( Context context, int hostId)
Public Methods
int allocateAppWidgetId ()
Get a appWidgetId for a host in the calling process.
final AppWidgetHostView createView ( Context context, int appWidgetId, AppWidgetProviderInfo appWidget)
Create the AppWidgetHostView for the given widget.
static void deleteAllHosts ()
Remove all records about all hosts for your package.
void deleteAppWidgetId (int appWidgetId)
Stop listening to changes for this AppWidget.
void deleteHost ()
Remove all records about this host from the AppWidget manager.
void startListening ()
Start receiving onAppWidgetChanged calls for your AppWidgets.
void stopListening ()
Stop receiving onAppWidgetChanged calls for your AppWidgets.
Protected Methods
void clearViews ()
Clear the list of Views that have been created by this AppWidgetHost.
AppWidgetHostView onCreateView ( Context context, int appWidgetId, AppWidgetProviderInfo appWidget)
Called to create the AppWidgetHostView. Override to return a custom subclass if you need it.
void onProviderChanged (int appWidgetId, AppWidgetProviderInfo appWidget)
Called when the AppWidget provider for a AppWidget has been upgraded to a new apk.
void onProvidersChanged ()
Called when the set of available widgets changes (ie.
[Expand]
Inherited Methods
From class java.lang.Object

Public Constructors

public AppWidgetHost ( Context context, int hostId)

Added in API level 3

Public Methods

public int allocateAppWidgetId ()

Added in API level 3

Get a appWidgetId for a host in the calling process.

Returns
  • a appWidgetId

public final AppWidgetHostView createView ( Context context, int appWidgetId, AppWidgetProviderInfo appWidget)

Added in API level 3

Create the AppWidgetHostView for the given widget. The AppWidgetHost retains a pointer to the newly-created View.

public static void deleteAllHosts ()

Added in API level 3

Remove all records about all hosts for your package.

  • Call this when initializing your database, as it might be because of a data wipe.
  • Call this to have the AppWidget manager release all resources associated with your host. Any future calls about this host will cause the records to be re-allocated.

public void deleteAppWidgetId (int appWidgetId)

Added in API level 3

Stop listening to changes for this AppWidget.

public void deleteHost ()

Added in API level 3

Remove all records about this host from the AppWidget manager.

  • Call this when initializing your database, as it might be because of a data wipe.
  • Call this to have the AppWidget manager release all resources associated with your host. Any future calls about this host will cause the records to be re-allocated.

public void startListening ()

Added in API level 3

Start receiving onAppWidgetChanged calls for your AppWidgets. Call this when your activity becomes visible, i.e. from onStart() in your Activity.

public void stopListening ()

Added in API level 3

Stop receiving onAppWidgetChanged calls for your AppWidgets. Call this when your activity is no longer visible, i.e. from onStop() in your Activity.

Protected Methods

protected void clearViews ()

Clear the list of Views that have been created by this AppWidgetHost.

protected AppWidgetHostView onCreateView ( Context context, int appWidgetId, AppWidgetProviderInfo appWidget)

Added in API level 3

Called to create the AppWidgetHostView. Override to return a custom subclass if you need it.

protected void onProviderChanged (int appWidgetId, AppWidgetProviderInfo appWidget)

Added in API level 3

Called when the AppWidget provider for a AppWidget has been upgraded to a new apk.

protected void onProvidersChanged ()

Called when the set of available widgets changes (ie. widget containing packages are added, updated or removed, or widget components are enabled or disabled.)