AppWidgetManager.RequestPinAppWidget Methode

Definition

Namespace:: Android.Appwidget

Assembly:: Mono.Android.dll

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.

Fordern Sie an, ein App-Widget auf dem aktuellen Startfeld anzuheften.

[Android.Runtime.Register("requestPinAppWidget", "(Landroid/content/ComponentName;Landroid/os/Bundle;Landroid/app/PendingIntent;)Z", "GetRequestPinAppWidget_Landroid_content_ComponentName_Landroid_os_Bundle_Landroid_app_PendingIntent_Handler", ApiSince=26)]
public virtual bool RequestPinAppWidget(Android.Content.ComponentName provider, Android.OS.Bundle? extras, Android.App.PendingIntent? successCallback);

[<Android.Runtime.Register("requestPinAppWidget", "(Landroid/content/ComponentName;Landroid/os/Bundle;Landroid/app/PendingIntent;)Z", "GetRequestPinAppWidget_Landroid_content_ComponentName_Landroid_os_Bundle_Landroid_app_PendingIntent_Handler", ApiSince=26)>]
abstract member RequestPinAppWidget : Android.Content.ComponentName * Android.OS.Bundle * Android.App.PendingIntent -> bool
override this.RequestPinAppWidget : Android.Content.ComponentName * Android.OS.Bundle * Android.App.PendingIntent -> bool

Parameter

provider: ComponentName

Der ComponentName für den android.content.BroadcastReceiver BroadcastReceiver Anbieter für Ihr AppWidget.

extras: Bundle

WENN nicht NULL, wird dies an die Startprogramm-App übergeben. Kann z. B. #EXTRA_APPWIDGET_PREVIEW für eine benutzerdefinierte Vorschau verwendet werden.

successCallback: PendingIntent

Wenn nicht NULL, wird diese Absicht gesendet, wenn das Widget erstellt wird.

Gibt zurück

Boolean

TRUE wenn das Startprogramm dieses Feature unterstützt. Beachten Sie, dass die API zurückgegeben wird, ohne darauf zu warten, dass der Benutzer darauf reagiert, sodass das Abrufen TRUE von dieser API nicht bedeutet, dass die Verknüpfung angeheftet ist. FALSE wenn das Startfeld dieses Feature nicht unterstützt oder die aufrufende App zu einem Benutzerprofil gehört, bei dem elemente auf der Startseite eingeschränkt sind.

Attribute: RegisterAttribute

Hinweise

Fordern Sie an, ein App-Widget auf dem aktuellen Startfeld anzuheften. Es liegt bei dem Startprogramm, diese Anforderung zu akzeptieren (optional eine Benutzerbestätigung). Wenn die Anforderung angenommen wird, erhält der Anrufer eine Bestätigung mit zusätzlichem .#EXTRA_APPWIDGET_ID

Wenn eine Anforderung vom Benutzer verweigert wird, erhält die Anrufer-App keine Antwort.

Nur Apps mit einer Vordergrundaktivität oder einem Vordergrunddienst können sie aufrufen. Andernfalls wird es ausgelöst IllegalStateException.

Es liegt an dem Startprogramm, wie vorherige ausstehende Anforderungen behandelt werden, wenn dasselbe Paket diese API mehrmals in einer Zeile aufruft. Sie kann beispielsweise die vorherigen Anforderungen ignorieren.

Das Startprogramm zeigt in diesem Fall nicht die konfigurationsaktivität an, die dem Anbieter zugeordnet ist. Die App kann entweder die Konfigurationsaktivität als Reaktion auf den Rückruf anzeigen oder vor dem Aufrufen der API anzeigen (verschiedene Konfigurationen können gekapselt successCallback werden, um zu vermeiden, dass sie beibehalten werden, bevor die WidgetId bekannt ist).

Java Dokumentation für android.appwidget.AppWidgetManager.requestPinAppWidget(android.content.ComponentName, android.os.Bundle, android.app.PendingIntent).

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: