org.robolectric.shadows

Class ShadowAppWidgetManager

java.lang.Object

org.robolectric.shadows.ShadowAppWidgetManager

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

Shadow for AppWidgetManager.

Constructor Summary

Constructors

Constructor and Description
ShadowAppWidgetManager()

Method Summary

Modifier and Type	Method and Description
void	addBoundWidget(int appWidgetId, android.appwidget.AppWidgetProviderInfo providerInfo)
void	addInstalledProvider(android.appwidget.AppWidgetProviderInfo appWidgetProviderInfo)
void	bindAppWidgetId(int appWidgetId, android.content.ComponentName provider)
boolean	bindAppWidgetIdIfAllowed(int appWidgetId, android.content.ComponentName provider)
int	createWidget(Class<? extends android.appwidget.AppWidgetProvider> appWidgetProviderClass, int widgetLayoutId) Creates a widget by inflating its layout.
int[]	createWidgets(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.
int[]	getAppWidgetIds(android.content.ComponentName provider)
android.appwidget.AppWidgetProviderInfo	getAppWidgetInfo(int appWidgetId)
android.appwidget.AppWidgetProvider	getAppWidgetProviderFor(int widgetId) Non-Android accessor.
List<android.appwidget.AppWidgetProviderInfo>	getInstalledProviders()
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	putWidgetInfo(int appWidgetId, android.appwidget.AppWidgetProviderInfo expectedWidgetInfo) Deprecated.
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	setAllowedToBindAppWidgets(boolean allowed)
void	setAlwaysRecreateViewsDuringUpdate(boolean alwaysRecreate) Non-Android mechanism that enables testing of widget behavior when all of the views are recreated on every update.
void	setValidWidgetProviderComponentName(boolean validWidgetProviderComponentName)
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

getAppWidgetIds

@Implementation
public int[] getAppWidgetIds(android.content.ComponentName provider)

getInstalledProviders

@Implementation
public List<android.appwidget.AppWidgetProviderInfo> getInstalledProviders()

addInstalledProvider

public void addInstalledProvider(android.appwidget.AppWidgetProviderInfo appWidgetProviderInfo)

addBoundWidget

public void addBoundWidget(int appWidgetId,
                           android.appwidget.AppWidgetProviderInfo providerInfo)

putWidgetInfo

@Deprecated
public void putWidgetInfo(int appWidgetId,
                                      android.appwidget.AppWidgetProviderInfo expectedWidgetInfo)

Deprecated.

getAppWidgetInfo

@Implementation
public android.appwidget.AppWidgetProviderInfo getAppWidgetInfo(int appWidgetId)

bindAppWidgetId

@HiddenApi
 @Implementation
public void bindAppWidgetId(int appWidgetId,
                                                        android.content.ComponentName provider)

bindAppWidgetIdIfAllowed

@Implementation
public boolean bindAppWidgetIdIfAllowed(int appWidgetId,
                                                        android.content.ComponentName provider)

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

setAllowedToBindAppWidgets

public void setAllowedToBindAppWidgets(boolean allowed)

setValidWidgetProviderComponentName

public void setValidWidgetProviderComponentName(boolean validWidgetProviderComponentName)