AppWidgetManager.PartiallyUpdateAppWidget Methode

Definition

Ü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).

Java Dokumentation für android.appwidget.AppWidgetManager.partiallyUpdateAppWidget(int, android.widget.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).

Java Dokumentation für android.appwidget.AppWidgetManager.partiallyUpdateAppWidget(int[], android.widget.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: