AppWidgetManager.PartiallyUpdateAppWidget Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| Name | Beschreibung |
|---|---|
| PartiallyUpdateAppWidget(Int32, RemoteViews) |
Führen Sie eine inkrementelle Aktualisierung oder einen Befehl für das von appWidgetId angegebene Widget aus. |
| PartiallyUpdateAppWidget(Int32[], RemoteViews) |
Führen Sie eine inkrementelle Aktualisierung oder einen Befehl für die Widgets aus, die von appWidgetIds angegeben werden. |
PartiallyUpdateAppWidget(Int32, RemoteViews)
Führen Sie eine inkrementelle Aktualisierung oder einen Befehl für das von appWidgetId angegebene Widget aus.
[Android.Runtime.Register("partiallyUpdateAppWidget", "(ILandroid/widget/RemoteViews;)V", "GetPartiallyUpdateAppWidget_ILandroid_widget_RemoteViews_Handler")]
public virtual void PartiallyUpdateAppWidget(int appWidgetId, Android.Widget.RemoteViews? views);
[<Android.Runtime.Register("partiallyUpdateAppWidget", "(ILandroid/widget/RemoteViews;)V", "GetPartiallyUpdateAppWidget_ILandroid_widget_RemoteViews_Handler")>]
abstract member PartiallyUpdateAppWidget : int * Android.Widget.RemoteViews -> unit
override this.PartiallyUpdateAppWidget : int * Android.Widget.RemoteViews -> unit
Parameter
- appWidgetId
- Int32
Die AppWidget-Instanz, für die die RemoteViews festgelegt werden soll.
- views
- RemoteViews
Das RemoteViews-Objekt, das die inkrementelle Aktualisierung/den Befehl enthält.
- Attribute
Hinweise
Führen Sie eine inkrementelle Aktualisierung oder einen Befehl für das von appWidgetId angegebene Widget aus.
Dieses Update unterscheidet sich davon #updateAppWidget(int, RemoteViews) , dass das übergebene RemoteViews-Objekt als unvollständige Darstellung des Widgets verstanden wird und daher nicht vom AppWidgetService zwischengespeichert wird. Beachten Sie, dass, da diese Updates nicht zwischengespeichert werden, alle Zustände, die sie ändern, die nicht durch restoreInstanceState wiederhergestellt werden, im Fall, dass die Widgets mithilfe der zwischengespeicherten Version in AppWidgetService wiederhergestellt werden.
Wird mit RemoteViews#showNext(int), RemoteViews#showPrevious(int)und RemoteViews#setScrollPosition(int, int) ähnlichen Befehlen verwendet.
Es ist in Ordnung, diese Methode sowohl innerhalb einer #ACTION_APPWIDGET_UPDATE Übertragung als auch außerhalb des Handlers aufzurufen. Diese Methode funktioniert nur, wenn sie von der UID aufgerufen wird, die den AppWidget-Anbieter besitzt.
Diese Methode wird ignoriert, wenn ein Widget keine vollständige Aktualisierung über #updateAppWidget(int[], RemoteViews).
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.
Gilt für:
PartiallyUpdateAppWidget(Int32[], RemoteViews)
Führen Sie eine inkrementelle Aktualisierung oder einen Befehl für die Widgets aus, die von appWidgetIds angegeben werden.
[Android.Runtime.Register("partiallyUpdateAppWidget", "([ILandroid/widget/RemoteViews;)V", "GetPartiallyUpdateAppWidget_arrayILandroid_widget_RemoteViews_Handler")]
public virtual void PartiallyUpdateAppWidget(int[]? appWidgetIds, Android.Widget.RemoteViews? views);
[<Android.Runtime.Register("partiallyUpdateAppWidget", "([ILandroid/widget/RemoteViews;)V", "GetPartiallyUpdateAppWidget_arrayILandroid_widget_RemoteViews_Handler")>]
abstract member PartiallyUpdateAppWidget : int[] * Android.Widget.RemoteViews -> unit
override this.PartiallyUpdateAppWidget : int[] * Android.Widget.RemoteViews -> unit
Parameter
- appWidgetIds
- Int32[]
Die AppWidget-Instanzen, für die die RemoteViews festgelegt werden sollen.
- views
- RemoteViews
Das RemoteViews-Objekt, das die inkrementelle Aktualisierung/den Befehl enthält.
- Attribute
Hinweise
Führen Sie eine inkrementelle Aktualisierung oder einen Befehl für die Widgets aus, die von appWidgetIds angegeben werden.
Dieses Update unterscheidet sich davon #updateAppWidget(int[], RemoteViews) , dass das remoteViews-Objekt, das übergeben wird, als unvollständige Darstellung des Widgets verstanden wird und daher die zwischengespeicherte Darstellung des Widgets nicht ersetzt. Ab API-Ebene 17 werden die neuen Eigenschaften, die in den Ansichtenobjekten festgelegt sind, an die zwischengespeicherte Darstellung des Widgets angefügt und daher beibehalten.
Wird mit RemoteViews#showNext(int), RemoteViews#showPrevious(int)und RemoteViews#setScrollPosition(int, int) ähnlichen Befehlen verwendet.
Es ist in Ordnung, diese Methode sowohl innerhalb einer #ACTION_APPWIDGET_UPDATE Übertragung als auch außerhalb des Handlers aufzurufen. Diese Methode funktioniert nur, wenn sie von der UID aufgerufen wird, die den AppWidget-Anbieter besitzt.
Diese Methode wird ignoriert, wenn ein Widget keine vollständige Aktualisierung über #updateAppWidget(int[], RemoteViews).
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.