ShortcutManager.RequestPinShortcut(ShortcutInfo, IntentSender) Metodo

Definizione

Spazio dei nomi:: Android.Content.PM

Assembly:: Mono.Android.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Richiedere di creare un collegamento aggiunto.

[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

Parametri

shortcut: ShortcutInfo

Collegamento da aggiungere. Se un'app vuole aggiungere un collegamento esistente (statico o dinamico), deve avere solo un ID. Anche se non è necessario impostare altri campi, è necessario abilitare il collegamento di destinazione.

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

resultIntent: IntentSender

Se non null, questa finalità verrà inviata quando viene aggiunto il collegamento. Usare android.app.PendingIntent#getIntentSender() per creare un oggetto IntentSender. Per evitare limiti di esecuzione in background, usare un ricevitore dichiarato dal manifesto non esportato. Per altri dettagli, vedere

           Creating pinned shortcuts.

Valori restituiti

Boolean

TRUE se l'utilità di avvio supporta questa funzionalità. Si noti che l'API verrà restituita senza attendere che l'utente risponda, quindi ottenere TRUE da questa API non significa che il collegamento sia stato aggiunto correttamente. FALSE se l'utilità di avvio non supporta questa funzionalità o se l'app chiamante appartiene a un profilo utente con elementi limitati nella schermata iniziale.

Attributi: RegisterAttribute

Commenti

Richiedere di creare un collegamento aggiunto. L'utilità di avvio predefinita riceverà questa richiesta e chiederà all'utente l'approvazione. Se l'utente lo approva, il collegamento verrà creato e resultIntent verrà inviato. Se una richiesta viene negata dall'utente, tuttavia, non verrà inviata alcuna risposta al chiamante.

Solo le app con un'attività in primo piano o un servizio in primo piano possono chiamare questo metodo. In caso contrario, genererà IllegalStateException.

Spetta all'utilità di avvio decidere come gestire le richieste in sospeso precedenti quando lo stesso pacchetto chiama questa API più volte in una riga. Una possibile strategia consiste nell'ignorare le richieste precedenti.

<b Nota:</b>> Vedere anche la controparte androidx.core.content.pm.ShortcutManagerCompat#requestPinShortcut( Context, ShortcutInfoCompat, IntentSender)della libreria di supporto , che supporta le versioni di Android inferiori rispetto VERSION_CODES#O all'uso della finalità com.android.launcher.action.INSTALL_SHORTCUTprivata legacy .

per android.content.pm.ShortcutManager.requestPinShortcut(android.content.pm.ShortcutInfo, android.content.IntentSender).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Si applica a