ShortcutManager.RequestPinShortcut(ShortcutInfo, IntentSender) Methode

Referenz

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

Tastenkombination zum Anheften. Wenn eine App eine vorhandene (statische oder dynamische) Verknüpfung anheften möchte, benötigt sie nur eine ID. 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. Verwenden Sie android.app.PendingIntent#getIntentSender() , um eine IntentSenderzu erstellen. Um Ausführungsbeschränkungen im Hintergrund zu vermeiden, verwenden Sie einen nicht exportierten, manifest deklarierten Empfänger. Weitere Informationen finden Sie unter

           Creating pinned shortcuts.

Gibt zurück

Boolean

TRUE , wenn das Startprogramm dieses Feature unterstützt. Beachten Sie, dass die API zurückgibt, ohne auf die Antwort des Benutzers zu warten, sodass das Abrufen TRUE von dieser API nicht bedeutet, dass die Verknüpfung erfolgreich angeheftet wurde. FALSE , wenn das Startprogramm dieses Feature nicht unterstützt.

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 jedoch vom Benutzer abgelehnt wird, wird keine Antwort an den Aufrufer gesendet.

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

Es liegt beim Startprogramm, zu entscheiden, wie vorherige ausstehende Anforderungen behandelt werden sollen, wenn dasselbe Paket diese API mehrmals hintereinander aufruft. Eine mögliche Strategie besteht darin, alle vorherigen Anforderungen zu ignorieren.

<b>Hinweis:</b> Siehe auch die Entsprechung androidx.core.content.pm.ShortcutManagerCompat#requestPinShortcut( Context, ShortcutInfoCompat, IntentSender)der Supportbibliothek , die Android-Versionen unterstützt, die niedriger als VERSION_CODES#O die Verwendung der privaten Legacyabsicht sind com.android.launcher.action.INSTALL_SHORTCUT.

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

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

Freigeben über