PendingIntent Classe
Définition
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.
Description d’une action Intention et cible à effectuer avec elle.
[Android.Runtime.Register("android/app/PendingIntent", DoNotGenerateAcw=true)]
public sealed class PendingIntent : Java.Lang.Object, Android.OS.IParcelable, IDisposable[<Android.Runtime.Register("android/app/PendingIntent", DoNotGenerateAcw=true)>]
type PendingIntent = class
inherit Object
interface IParcelable
interface IJavaObject
interface IDisposable
interface IJavaPeerable- Héritage
- Attributs
- Implémente
Remarques
Description d’une action Intention et cible à effectuer avec elle. Les instances de cette classe sont créées avec getActivity(Context, int, Intent, int), getActivities(Context, int, Intent, int), getBroadcast(Context, int, Intent, int) et getService(Context, int, Intent, Int) ; l’objet retourné peut être remis à d’autres applications afin qu’ils puissent effectuer l’action que vous avez décrite en votre nom ultérieurement. En accordant un PendingIntent à une autre application, vous lui accordez le droit d’effectuer l’opération que vous avez spécifiée comme si l’autre application était vous-même (avec les mêmes autorisations et identité). Par conséquent, vous devez être prudent sur la façon dont vous générez l’élément PendingIntent : presque toujours, par exemple, l’intention de base que vous fournissez doit avoir le nom du composant explicitement défini sur l’un de vos propres composants, pour vous assurer qu’il est finalement envoyé là et nulle part ailleurs. Un PendingIntent lui-même est simplement une référence à un jeton géré par le système décrivant les données d’origine utilisées pour la récupérer. Cela signifie que, même si le processus de son application propriétaire est tué, l’PendingIntent lui-même reste utilisable à partir d’autres processus qui lui ont été donnés. Si l’application de création récupère ultérieurement le même type d’PendingIntent (même opération, même action Intent, données, catégories et composants, et les mêmes indicateurs), il reçoit un PendingIntent représentant le même jeton s’il est toujours valide et peut donc appeler cancel() pour le supprimer. En raison de ce comportement, il est important de savoir quand deux intentions sont considérées comme identiques à des fins de récupération d’un PendingIntent. Une erreur courante que les utilisateurs font consiste à créer plusieurs objets PendingIntent avec des intentions qui varient uniquement dans leur contenu « supplémentaire », s’attendant à obtenir un autre PendingIntent chaque fois. Cela n’arrive pas. Les parties de l’intention utilisées pour la correspondance sont les mêmes que celles définies par Intent.filterEquals. Si vous utilisez deux objets Intent équivalents en fonction de Intent.filterEquals, vous obtiendrez le même PendingIntent pour les deux. Il existe deux façons typiques de traiter ce problème. Si vous avez vraiment besoin de plusieurs objets PendingIntent distincts actifs en même temps (par exemple, pour utiliser deux notifications affichées en même temps), vous devez vous assurer qu’il existe quelque chose de différent à leur sujet pour les associer à différents PendingIntents. Il peut s’agir de l’un des attributs Intent.filterEquals ou des entiers de code de requête différents fournis à getActivity(Context, int, Intent, int), getActivities(Context, int, Intent, int), getBroadcast(Context, int, Intent, int) ou getService(Context, int, Intent, Int). Si vous n’avez besoin qu’d’une seule instance PendingIntent active à la fois pour l’une des intentions que vous utiliserez, vous pouvez également utiliser les indicateurs FLAG_CANCEL_CURRENT ou FLAG_UPDATE_CURRENT pour annuler ou modifier l’objet PendingIntent actuel associé à l’intention que vous fournissez. Notez également que les indicateurs tels que FLAG_ONE_SHOT ou FLAG_IMMUTABLE décrivent l’instance PendingIntent et sont donc utilisés pour l’identifier. Tous les appels pour récupérer ou modifier un PendingIntent créé avec ces indicateurs nécessitent également que ces indicateurs soient fournis conjointement avec d’autres personnes. Par exemple, pour récupérer un pendingIntent existant créé avec FLAG_ONE_SHOT, FLAG_ONE_SHOT et FLAG_NO_CREATE doivent être fournis.
Référence Android pour 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.
Champs
| Nom | Description |
|---|---|
| FlagAllowUnsafeImplicitIntent |
Obsolète.
Indicateur indiquant que l’objet PendingIntent créé avec |
| FlagMutable |
Obsolète.
Indicateur indiquant que l’élément PendingIntent créé doit être mutable. |
Propriétés
| Nom | Description |
|---|---|
| Class |
Retourne la classe runtime de ce |
| Creator | |
| CreatorPackage |
Retournez le nom du package de l’application qui a créé cet PendingIntent, c’est-à-dire l’identité sous laquelle vous envoyez réellement l’intention. |
| CreatorUid |
Retournez l’uid de l’application qui a créé cet PendingIntent, c’est-à-dire l’identité sous laquelle vous envoyez réellement l’intention. |
| CreatorUserHandle |
Retournez le handle utilisateur de l’application qui a créé cet PendingIntent, c’est-à-dire l’utilisateur sous lequel vous envoyez réellement l’intention. |
| Handle |
Handle de l’instance Android sous-jacente. (Hérité de Object) |
| IntentSender |
Récupérer un objet IntentSender qui encapsule l’expéditeur existant de PendingIntent |
| IsActivity | |
| IsBroadcast | |
| IsForegroundService | |
| IsImmutable |
Vérifiez si cette propriété PendingIntent est marquée avec |
| IsService | |
| JniIdentityHashCode |
Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Object) |
| JniManagedPeerState |
Description d’une action Intention et cible à effectuer avec elle. (Hérité de JavaObject) |
| JniPeerMembers |
Fournit une infrastructure de liaison JNI pour Android.App.PendingIntent. |
| PeerReference |
Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object) |
| TargetPackage |
Obsolète.
Cette méthode a été déconseillée au niveau de l’API 17. |
| ThresholdClass |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. (Hérité de Object) |
| ThresholdType |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. (Hérité de Object) |
Méthodes
| Nom | Description |
|---|---|
| Cancel() |
Annulez un PendingIntent actuellement actif. |
| Clone() |
Crée et retourne une copie de cet objet. (Hérité de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Description d’une action Intention et cible à effectuer avec elle. (Hérité de JavaObject) |
| DescribeContents() |
Décrivez les types d’objets spéciaux contenus dans la représentation marshalée de cette instance Parcelable. |
| Dispose() |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| Dispose(Boolean) |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| DisposeUnlessReferenced() |
Description d’une action Intention et cible à effectuer avec elle. (Hérité de JavaObject) |
| Equals(Object) |
Description d’une action Intention et cible à effectuer avec elle. (Hérité de JavaObject) |
| Equals(Object) |
Indique si un autre objet est « égal à » celui-ci. (Hérité de Object) |
| GetActivities(Context, Int32, Intent[], PendingIntentFlags, Bundle) |
Comme |
| GetActivities(Context, Int32, Intent[], PendingIntentFlags) |
Comme |
| GetActivity(Context, Int32, Intent, PendingIntentFlags, Bundle) |
Récupérez un PendingIntent qui démarrera une nouvelle activité, comme l’appel |
| GetActivity(Context, Int32, Intent, PendingIntentFlags) |
Récupérez un PendingIntent qui démarrera une nouvelle activité, comme l’appel |
| GetBroadcast(Context, Int32, Intent, PendingIntentFlags) |
Récupérez un PendingIntent qui effectuera une diffusion, comme l’appel |
| GetForegroundService(Context, Int32, Intent, PendingIntentFlags) |
Récupérez un PendingIntent qui démarrera un service de premier plan, comme l’appel |
| GetHashCode() |
Retourne une valeur de code de hachage pour l’objet. (Hérité de Object) |
| GetService(Context, Int32, Intent, PendingIntentFlags) |
Récupérez un PendingIntent qui démarrera un service, comme l’appel |
| JavaFinalize() |
Obsolète.
Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object) |
| Notify() |
Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object) |
| NotifyAll() |
Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object) |
| ReadPendingIntentOrNullFromParcel(Parcel) |
Fonction pratique pour lire un pointeur PendingIntent ou Null à partir d’un colis. |
| Send() |
Effectuez l’opération associée à cet PendingIntent. |
| Send(Bundle) |
Effectuez l’opération associée à cet PendingIntent, en fournissant des options supplémentaires pour l’opération. |
| Send(Context, Result, Intent, PendingIntent+IOnFinished, Handler, String, Bundle) |
Effectuez l’opération associée à ce PendingIntent, ce qui permet à l’appelant de spécifier des informations sur l’intention à utiliser et d’être averti lorsque l’envoi est terminé. |
| Send(Context, Result, Intent, PendingIntent+IOnFinished, Handler, String) |
Effectuez l’opération associée à ce PendingIntent, ce qui permet à l’appelant de spécifier des informations sur l’intention à utiliser et d’être averti lorsque l’envoi est terminé. |
| Send(Context, Result, Intent, PendingIntent+IOnFinished, Handler) |
Effectuez l’opération associée à ce PendingIntent, ce qui permet à l’appelant de spécifier des informations sur l’intention à utiliser et d’être averti lorsque l’envoi est terminé. |
| Send(Context, Result, Intent) |
Effectuez l’opération associée à ce PendingIntent, ce qui permet à l’appelant de spécifier des informations sur l’intention à utiliser. |
| Send(Result, PendingIntent+IOnFinished, Handler) |
Effectuez l’opération associée à ce PendingIntent, ce qui permet à l’appelant d’être averti lorsque l’envoi est terminé. |
| Send(Result) |
Effectuez l’opération associée à cet PendingIntent. |
| SetHandle(IntPtr, JniHandleOwnership) |
Définit la propriété Handle. (Hérité de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Description d’une action Intention et cible à effectuer avec elle. (Hérité de JavaObject) |
| ToArray<T>() |
Crée un tableau managé à partir de ce wrapper de tableau Java. (Hérité de Object) |
| ToString() |
Retourne une représentation sous forme de chaîne de l’objet. (Hérité de Object) |
| UnregisterFromRuntime() |
Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité. (Hérité de Object) |
| Wait() |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object) |
| Wait(Int64, Int32) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
| Wait(Int64) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
| WritePendingIntentOrNullToParcel(PendingIntent, Parcel) |
Fonction pratique pour écrire un pointeur PendingIntent ou Null vers un colis. |
| WriteToParcel(Parcel, ParcelableWriteFlags) |
Aplatir cet objet dans un colis. |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IJavaPeerable.Disposed() |
Description d’une action Intention et cible à effectuer avec elle. (Hérité de JavaObject) |
| IJavaPeerable.Finalized() |
Description d’une action Intention et cible à effectuer avec elle. (Hérité de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Description d’une action Intention et cible à effectuer avec elle. (Hérité de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Description d’une action Intention et cible à effectuer avec elle. (Hérité de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Description d’une action Intention et cible à effectuer avec elle. (Hérité de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Description d’une action Intention et cible à effectuer avec elle. (Hérité de JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
Description d’une action Intention et cible à effectuer avec elle. |
Méthodes d’extension
| Nom | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtient le nom JNI du type de l’instance |
| JavaAs<TResult>(IJavaPeerable) |
Essayez de forcer |
| JavaCast<TResult>(IJavaObject) |
Effectue une conversion de type vérifiée par le runtime Android. |
| JavaCast<TResult>(IJavaObject) |
Description d’une action Intention et cible à effectuer avec elle. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Essayez de forcer |