AppWidgetProvider.OnRestored(Context, Int32[], Int32[]) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Called in response to the AppWidgetManager#ACTION_APPWIDGET_RESTORED broadcast
when instances of this AppWidget provider have been restored from backup.
[Android.Runtime.Register("onRestored", "(Landroid/content/Context;[I[I)V", "GetOnRestored_Landroid_content_Context_arrayIarrayIHandler")]
public virtual void OnRestored (Android.Content.Context? context, int[]? oldWidgetIds, int[]? newWidgetIds);[<Android.Runtime.Register("onRestored", "(Landroid/content/Context;[I[I)V", "GetOnRestored_Landroid_content_Context_arrayIarrayIHandler")>]
abstract member OnRestored : Android.Content.Context * int[] * int[] -> unit
override this.OnRestored : Android.Content.Context * int[] * int[] -> unitParameters
- context
- Context
context
- oldWidgetIds
- Int32[]
oldWidgetIds
- newWidgetIds
- Int32[]
newWidgetIds
- Attributes
Remarks
Called in response to the AppWidgetManager#ACTION_APPWIDGET_RESTORED broadcast when instances of this AppWidget provider have been restored from backup. If your provider maintains any persistent data about its widget instances, override this method to remap the old AppWidgetIds to the new values and update any other app state that may be relevant.
This callback will be followed immediately by a call to #onUpdate so your provider can immediately generate new RemoteViews suitable for its newly-restored set of instances.
In addition, you should set AppWidgetManager#OPTION_APPWIDGET_RESTORE_COMPLETED to true indicate if a widget has been restored successfully from the provider's side.
{
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.