ShortcutManager.RequestPinShortcut(ShortcutInfo, IntentSender) Methode

Definition

Namespace:: Android.Content.PM

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.

Anforderung zum Erstellen einer angehefteten Verknüpfung.

[Android.Runtime.Register("requestPinShortcut", "(Landroid/content/pm/ShortcutInfo;Landroid/content/IntentSender;)Z", "GetRequestPinShortcut_Landroid_content_pm_ShortcutInfo_Landroid_content_IntentSender_Handler", ApiSince=26)]
public virtual bool RequestPinShortcut(Android.Content.PM.ShortcutInfo shortcut, Android.Content.IntentSender? resultIntent);

[<Android.Runtime.Register("requestPinShortcut", "(Landroid/content/pm/ShortcutInfo;Landroid/content/IntentSender;)Z", "GetRequestPinShortcut_Landroid_content_pm_ShortcutInfo_Landroid_content_IntentSender_Handler", ApiSince=26)>]
abstract member RequestPinShortcut : Android.Content.PM.ShortcutInfo * Android.Content.IntentSender -> bool
override this.RequestPinShortcut : Android.Content.PM.ShortcutInfo * Android.Content.IntentSender -> bool

Parameter

shortcut: ShortcutInfo

Verknüpfung zum Anheften. Wenn eine App eine vorhandene (statische oder dynamische) Verknüpfung anheften möchte, muss sie nur über eine ID verfügen. Obwohl andere Felder nicht festgelegt werden müssen, muss die Zielverknüpfung aktiviert sein.

            &lt;p&gt;If it's a new shortcut, all the mandatory fields, such as a short label, must be
            set.

resultIntent: IntentSender

Wenn nicht NULL, wird diese Absicht gesendet, wenn die Verknüpfung angeheftet wird. Dient android.app.PendingIntent#getIntentSender() zum Erstellen eines IntentSender. Verwenden Sie einen nicht exportierenden, manifest deklarierten Empfänger, um Hintergrundausführungsgrenzwerte zu vermeiden. Weitere Details finden Sie unter

           Creating pinned shortcuts.

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 erfolgreich angeheftet wurde. 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. Wenn die App-Sperre für die aufrufende App aktiviert ist, werden Verknüpfungsanheftungsanforderungen abgelehnt, und diese Methode wird zurückgegeben false.

Attribute: RegisterAttribute

Hinweise

Anforderung zum Erstellen einer angehefteten Verknüpfung. Das Standardstartprogramm empfängt diese Anforderung und fordert den Benutzer zur Genehmigung auf. Wenn der Benutzer dies genehmigt, wird die Verknüpfung erstellt und resultIntent gesendet. Wenn eine Anforderung vom Benutzer verweigert wird, wird jedoch keine Antwort an den Anrufer gesendet.

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

Es liegt an dem Startprogramm, zu entscheiden, wie vorherige ausstehende Anforderungen behandelt werden, wenn dasselbe Paket diese API mehrmals in einer Zeile aufruft. Eine mögliche Strategie besteht darin, alle vorherigen Anforderungen zu ignorieren.

<b>Hinweis:</b> Siehe auch das Supportbibliothek-Gegenstück androidx.core.content.pm.ShortcutManagerCompat#requestPinShortcut( Context, ShortcutInfoCompat, IntentSender), das Android-Versionen unterstützt, die niedriger als VERSION_CODES#O die Verwendung der älteren privaten Absicht com.android.launcher.action.INSTALL_SHORTCUTsind.

Java Dokumentation für android.content.pm.ShortcutManager.requestPinShortcut(android.content.pm.ShortcutInfo, android.content.IntentSender).

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: