AppWidgetManager.RequestPinAppWidget Metodo

Definizione

Spazio dei nomi:: Android.Appwidget

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 aggiungere un widget dell'app sull'icona di avvio corrente.

[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

Parametri

provider: ComponentName

Oggetto ComponentName per il android.content.BroadcastReceiver BroadcastReceiver provider per AppWidget.

extras: Bundle

SE non null, questo viene passato all'app di avvio. Ad esempio, #EXTRA_APPWIDGET_PREVIEW può essere usato per un'anteprima personalizzata.

successCallback: PendingIntent

Se non null, questa finalità verrà inviata al momento della creazione del widget.

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 venga aggiunto. 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 aggiungere un widget dell'app sull'icona di avvio corrente. Spetta all'utilità di avvio accettare questa richiesta (facoltativamente visualizzando una conferma dell'utente). Se la richiesta viene accettata, il chiamante riceverà una conferma con un valore aggiuntivo #EXTRA_APPWIDGET_ID.

Quando una richiesta viene negata dall'utente, l'app chiamante non riceverà alcuna risposta.

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

Spetta all'utilità di avvio come gestire le richieste in sospeso precedenti quando lo stesso pacchetto chiama questa API più volte in una riga. Può ignorare le richieste precedenti, ad esempio.

L'utilità di avvio non visualizzerà l'attività di configurazione associata al provider in questo caso. L'app può mostrare l'attività di configurazione come risposta al callback o mostrare se prima di chiamare l'API (è possibile incapsulare varie configurazioni in successCallback per evitare di renderle persistenti prima che il widgetId sia noto).

per android.appwidget.AppWidgetManager.requestPinAppWidget(android.content.ComponentName, android.os.Bundle, android.app.PendingIntent).

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