com.xtremelabs.robolectric.shadows
Class ShadowAppWidgetManager

java.lang.Object
  extended by com.xtremelabs.robolectric.shadows.ShadowAppWidgetManager

@Implements(value=android.appwidget.AppWidgetManager.class)
public class ShadowAppWidgetManager
extends java.lang.Object


Constructor Summary
ShadowAppWidgetManager()
           
 
Method Summary
 int createWidget(java.lang.Class<? extends android.appwidget.AppWidgetProvider> appWidgetProviderClass, int widgetLayoutId)
          Creates a widget by inflating its layout.
 int[] createWidgets(java.lang.Class<? extends android.appwidget.AppWidgetProvider> appWidgetProviderClass, int widgetLayoutId, int howManyToCreate)
          Creates a bunch of widgets by inflating the same layout multiple times.
 boolean getAlwaysRecreateViewsDuringUpdate()
          Non-Android accessor.
 android.appwidget.AppWidgetProvider getAppWidgetProviderFor(int widgetId)
          Non-Android accessor.
static android.appwidget.AppWidgetManager getInstance(android.content.Context context)
          Finds or creates an AppWidgetManager for the given context
 android.view.View getViewFor(int widgetId)
          Non-Android accessor.
 void reconstructWidgetViewAsIfPhoneWasRotated(int appWidgetId)
          Triggers a reapplication of the most recent set of actions against the widget, which is what happens when the phone is rotated.
 void setAlwaysRecreateViewsDuringUpdate(boolean alwaysRecreate)
          Non-Android mechanism that enables testing of widget behavior when all of the views are recreated on every update.
 void updateAppWidget(int[] appWidgetIds, android.widget.RemoteViews views)
           
 void updateAppWidget(int appWidgetId, android.widget.RemoteViews views)
          Simulates updating an AppWidget with a new set of views
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ShadowAppWidgetManager

public ShadowAppWidgetManager()
Method Detail

getInstance

@Implementation
public static android.appwidget.AppWidgetManager getInstance(android.content.Context context)
Finds or creates an AppWidgetManager for the given context

Parameters:
context - the context for which to produce an assoicated AppWidgetManager
Returns:
the AppWidgetManager associated with the given context

updateAppWidget

@Implementation
public void updateAppWidget(int[] appWidgetIds,
                                           android.widget.RemoteViews views)

updateAppWidget

@Implementation
public void updateAppWidget(int appWidgetId,
                                           android.widget.RemoteViews views)
Simulates updating an AppWidget with a new set of views

Parameters:
appWidgetId - id of widget
views - views to update

reconstructWidgetViewAsIfPhoneWasRotated

public void reconstructWidgetViewAsIfPhoneWasRotated(int appWidgetId)
Triggers a reapplication of the most recent set of actions against the widget, which is what happens when the phone is rotated. Does not attempt to simulate a change in screen geometry.

Parameters:
appWidgetId - the ID of the widget to be affected

createWidget

public int createWidget(java.lang.Class<? extends android.appwidget.AppWidgetProvider> appWidgetProviderClass,
                        int widgetLayoutId)
Creates a widget by inflating its layout.

Parameters:
appWidgetProviderClass - the app widget provider class
widgetLayoutId - id of the layout to inflate
Returns:
the ID of the new widget

createWidgets

public int[] createWidgets(java.lang.Class<? extends android.appwidget.AppWidgetProvider> appWidgetProviderClass,
                           int widgetLayoutId,
                           int howManyToCreate)
Creates a bunch of widgets by inflating the same layout multiple times.

Parameters:
appWidgetProviderClass - the app widget provider class
widgetLayoutId - id of the layout to inflate
howManyToCreate - number of new widgets to create
Returns:
the IDs of the new widgets

getViewFor

public android.view.View getViewFor(int widgetId)
Non-Android accessor.

Parameters:
widgetId - id of the desired widget
Returns:
the widget associated with widgetId

getAppWidgetProviderFor

public android.appwidget.AppWidgetProvider getAppWidgetProviderFor(int widgetId)
Non-Android accessor.

Parameters:
widgetId - id of the widget whose provider is to be returned
Returns:
the AppWidgetProvider associated with widgetId

setAlwaysRecreateViewsDuringUpdate

public void setAlwaysRecreateViewsDuringUpdate(boolean alwaysRecreate)
Non-Android mechanism that enables testing of widget behavior when all of the views are recreated on every update. This is useful for ensuring that your widget will behave correctly even if it is restarted by the OS between events.

Parameters:
alwaysRecreate - whether or not to always recreate the views

getAlwaysRecreateViewsDuringUpdate

public boolean getAlwaysRecreateViewsDuringUpdate()
Non-Android accessor.

Returns:
the state of thealwaysRecreateViewsDuringUpdate flag