AppWidgetManager.RequestPinAppWidget Méthode

Définition

Espace de noms:: Android.Appwidget

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Demande d’épingler un widget d’application sur le lanceur actuel.

[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

Paramètres

provider: ComponentName

Pour ComponentName le android.content.BroadcastReceiver BroadcastReceiver fournisseur de votre AppWidget.

extras: Bundle

Si la valeur n’est pas null, elle est passée à l’application de lanceur. Par exemple, #EXTRA_APPWIDGET_PREVIEW vous pouvez l’utiliser pour une préversion personnalisée.

successCallback: PendingIntent

S’il n’est pas null, cette intention est envoyée lors de la création du widget.

Retours

Boolean

TRUE si le lanceur prend en charge cette fonctionnalité. Notez que l’API retourne sans attendre que l’utilisateur réponde. Par conséquent, l’obtention TRUE à partir de cette API ne signifie pas que le raccourci est épinglé. FALSE si le lanceur ne prend pas en charge cette fonctionnalité ou si l’application appelante appartient à un profil utilisateur avec des éléments restreints sur l’écran d’accueil.

Attributs: RegisterAttribute

Remarques

Demande d’épingler un widget d’application sur le lanceur actuel. Il appartient au lanceur d’accepter cette demande (éventuellement en affichant une confirmation de l’utilisateur). Si la demande est acceptée, l’appelant obtient une confirmation avec un supplément #EXTRA_APPWIDGET_ID.

Lorsqu’une demande est refusée par l’utilisateur, l’application appelante n’obtient aucune réponse.

Seules les applications avec une activité de premier plan ou un service de premier plan peuvent l’appeler. Sinon, il lèvera IllegalStateException.

C’est au lanceur comment gérer les requêtes en attente précédentes lorsque le même package appelle cette API plusieurs fois dans une ligne. Il peut ignorer les demandes précédentes, par exemple.

Le lanceur n’affiche pas l’activité de configuration associée au fournisseur dans ce cas. L’application peut afficher l’activité de configuration en réponse au rappel ou indiquer si avant d’appeler l’API (différentes configurations peuvent être encapsulées successCallback pour éviter de les conserver avant que le widgetId soit connu).

Java documentation pour android.appwidget.AppWidgetManager.requestPinAppWidget(android.content.ComponentName, android.os.Bundle, android.app.PendingIntent).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

S’applique à