PendingIntent Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Descripción de una acción Intención y destino que se va a realizar con ella.
[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
- Herencia
- Atributos
- Implementaciones
Comentarios
Descripción de una acción Intención y destino que se va a realizar con ella. Las instancias de esta clase se crean con getActivity(Context, int, Intent, int), getActivities(Context, int, Intent, int), getBroadcast(Context, int, Intent, int) y getService(Context, int, Intent, int); el objeto devuelto se puede entregar a otras aplicaciones para que puedan realizar la acción que ha descrito en su nombre más adelante. Al conceder una instrucción PendingIntent a otra aplicación, se le concede el derecho de realizar la operación que ha especificado como si la otra aplicación fuera usted mismo (con los mismos permisos e identidad). Por lo tanto, debe tener cuidado de cómo compile PendingIntent: casi siempre, por ejemplo, la intención base que proporcione debe tener el nombre del componente establecido explícitamente en uno de sus propios componentes, para asegurarse de que se envía en última instancia allí y en ninguna otra parte. Un elemento PendingIntent es simplemente una referencia a un token mantenido por el sistema que describe los datos originales usados para recuperarlo. Esto significa que, incluso si se elimina el proceso de su propia aplicación, el propio PendingIntent seguirá siendo utilizable de otros procesos que se le hayan dado. Si la aplicación de creación vuelve a recuperar el mismo tipo de PendingIntent (misma operación, la misma acción intención, los datos, las categorías y los componentes y las mismas marcas), recibirá un PendingIntent que representa el mismo token si sigue siendo válido y, por tanto, puede llamar a cancel() para quitarlo. Debido a este comportamiento, es importante saber cuándo se consideran que dos intenciones son las mismas con el fin de recuperar un objeto PendingIntent. Un error común que hacen las personas es crear varios objetos PendingIntent con intenciones que solo varían en su contenido "adicional", esperando obtener un valor PendingIntent diferente cada vez. Esto no sucede. Las partes de la intención que se usan para buscar coincidencias son las mismas definidas por Intent.filterEquals. Si usa dos objetos Intent equivalentes según Intent.filterEquals, obtendrá el mismo PendingIntent para ambos. Hay dos maneras típicas de tratar con esto. Si realmente necesita varios objetos PendingIntent distintos activos al mismo tiempo (por ejemplo, para usar como dos notificaciones que se muestran al mismo tiempo), deberá asegurarse de que hay algo diferente sobre ellos para asociarlos a diferentes PendingIntents. Esto puede ser cualquiera de los atributos Intent considerados por Intent.filterEquals, o enteros de código de solicitud diferentes proporcionados a getActivity(Context, int, Intent, int), getActivities(Context, int, Intent, int), getBroadcast(Context, int, Intent, int) o getService(Context, int, Intent, int). Si solo necesita un PendingIntent activo a la vez para cualquiera de las intenciones que va a usar, también puede usar las marcas FLAG_CANCEL_CURRENT o FLAG_UPDATE_CURRENT para cancelar o modificar cualquier objeto PendingIntent actual asociado a la intención que proporcione. Tenga en cuenta también que las marcas como FLAG_ONE_SHOT o FLAG_IMMUTABLE describen la instancia de PendingIntent y, por tanto, se usan para identificarla. Cualquier llamada para recuperar o modificar un PendingIntent creado con estas marcas también requerirá que estas marcas se proporcionen junto con otras personas. Por ejemplo, para recuperar un elemento PendingIntent existente creado con FLAG_ONE_SHOT, es necesario proporcionar tanto FLAG_ONE_SHOT como FLAG_NO_CREATE.
Referencia de Android para android.app.PendingIntent.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.
Campos
| Nombre | Description |
|---|---|
| FlagAllowUnsafeImplicitIntent |
Obsoletos.
Marca que indica que el objeto PendingIntent creado con FLAG_MUTABLE puede tener una intención implícita no segura. |
| FlagMutable |
Obsoletos.
Marca que indica que el objeto PendingIntent creado debe ser mutable. |
Propiedades
| Nombre | Description |
|---|---|
| Class |
Devuelve la clase en tiempo de ejecución de este |
| Creator |
Descripción de una acción Intención y destino que se va a realizar con ella. |
| CreatorPackage |
Devuelve el nombre del paquete de la aplicación que creó este PendingIntent, que es la identidad con la que realmente enviarás la intención. |
| CreatorUid |
Devuelve la interfaz de usuario de la aplicación que creó este PendingIntent, que es la identidad en la que realmente se va a enviar la intención. |
| CreatorUserHandle |
Devuelve el identificador de usuario de la aplicación que creó este PendingIntent, que es el usuario en el que realmente va a enviar la intención. |
| Handle |
Identificador de la instancia de Android subyacente. (Heredado de Object) |
| IntentSender |
Recuperar un objeto IntentSender que encapsula el remitente existente del PendingIntent |
| IsActivity |
Descripción de una acción Intención y destino que se va a realizar con ella. |
| IsBroadcast |
Descripción de una acción Intención y destino que se va a realizar con ella. |
| IsForegroundService |
Descripción de una acción Intención y destino que se va a realizar con ella. |
| IsImmutable |
Compruebe si PendingIntent está marcado con FLAG_IMMUTABLE. |
| IsService |
Descripción de una acción Intención y destino que se va a realizar con ella. |
| JniIdentityHashCode |
Obtiene el código hash de identidad asignado a este Java del mismo nivel por el tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| JniManagedPeerState |
Descripción de una acción Intención y destino que se va a realizar con ella. (Heredado de JavaObject) |
| JniPeerMembers |
Proporciona la infraestructura de enlace JNI para Android.App.PendingIntent. |
| PeerReference |
Obtiene la referencia de objeto JNI para este Java del mismo nivel. (Heredado de Object) |
| TargetPackage |
Obsoletos.
Este método estaba en desuso en el nivel de API 17. |
| ThresholdClass |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. (Heredado de Object) |
| ThresholdType |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. (Heredado de Object) |
Métodos
| Nombre | Description |
|---|---|
| Cancel() |
Cancele una instancia de PendingIntent activa actualmente. |
| Clone() |
Crea y devuelve una copia de este objeto. (Heredado de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Descripción de una acción Intención y destino que se va a realizar con ella. (Heredado de JavaObject) |
| DescribeContents() |
Describir los tipos de objetos especiales contenidos en la representación serializado de esta instancia de Parcelable. |
| Dispose() |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| Dispose(Boolean) |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| DisposeUnlessReferenced() |
Descripción de una acción Intención y destino que se va a realizar con ella. (Heredado de JavaObject) |
| Equals(Object) |
Descripción de una acción Intención y destino que se va a realizar con ella. (Heredado de JavaObject) |
| Equals(Object) |
Indica si algún otro objeto es "igual a" este. (Heredado de Object) |
| GetActivities(Context, Int32, Intent[], PendingIntentFlags, Bundle) |
Al igual que getActivity(Context,int,Intent,int), pero permite proporcionar una matriz de intenciones. |
| GetActivities(Context, Int32, Intent[], PendingIntentFlags) |
Al igual que getActivity(Context,int,Intent,int), pero permite proporcionar una matriz de intenciones. |
| GetActivity(Context, Int32, Intent, PendingIntentFlags, Bundle) |
Recupere un PendingIntent que iniciará una nueva actividad, como llamar a Context.startActivity(Intent). |
| GetActivity(Context, Int32, Intent, PendingIntentFlags) |
Recupere un PendingIntent que iniciará una nueva actividad, como llamar a Context.startActivity(Intent). |
| GetBroadcast(Context, Int32, Intent, PendingIntentFlags) |
Recupere un PendingIntent que realizará una difusión, como llamar a Context.sendBroadcast(). |
| GetForegroundService(Context, Int32, Intent, PendingIntentFlags) |
Recupere un PendingIntent que iniciará un servicio en primer plano, como llamar a Context.startForegroundService(). |
| GetHashCode() |
Devuelve un valor de código hash para el objeto . (Heredado de Object) |
| GetService(Context, Int32, Intent, PendingIntentFlags) |
Recupere un PendingIntent que inicie un servicio, como llamar a Context.startService(). |
| JavaFinalize() |
Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto . (Heredado de Object) |
| Notify() |
Activa un único subproceso que está esperando en el monitor de este objeto. (Heredado de Object) |
| NotifyAll() |
Activa todos los subprocesos que están esperando en el monitor de este objeto. (Heredado de Object) |
| ReadPendingIntentOrNullFromParcel(Parcel) |
Función de conveniencia para leer un puntero PendingIntent o null de un paquete. |
| Send() |
Realice la operación asociada a este PendingIntent. |
| Send(Bundle) |
Realice la operación asociada a este PendingIntent y proporcione opciones adicionales para la operación. |
| Send(Context, Result, Intent, PendingIntent+IOnFinished, Handler, String, Bundle) |
Realice la operación asociada a este PendingIntent, lo que permite al autor de la llamada especificar información sobre la intención que se va a usar y recibir una notificación cuando se haya completado el envío. |
| Send(Context, Result, Intent, PendingIntent+IOnFinished, Handler, String) |
Realice la operación asociada a este PendingIntent, lo que permite al autor de la llamada especificar información sobre la intención que se va a usar y recibir una notificación cuando se haya completado el envío. |
| Send(Context, Result, Intent, PendingIntent+IOnFinished, Handler) |
Realice la operación asociada a este PendingIntent, lo que permite al autor de la llamada especificar información sobre la intención que se va a usar y recibir una notificación cuando se haya completado el envío. |
| Send(Context, Result, Intent) |
Realice la operación asociada a este objeto PendingIntent, lo que permite al autor de la llamada especificar información sobre la intención que se va a usar. |
| Send(Result, PendingIntent+IOnFinished, Handler) |
Realice la operación asociada a este PendingIntent, lo que permite que se notifique al autor de la llamada cuando se haya completado el envío. |
| Send(Result) |
Realice la operación asociada a este PendingIntent. |
| SetHandle(IntPtr, JniHandleOwnership) |
Establece la propiedad Handle. (Heredado de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Descripción de una acción Intención y destino que se va a realizar con ella. (Heredado de JavaObject) |
| ToArray<T>() |
Crea una matriz administrada a partir de este contenedor de matriz Java. (Heredado de Object) |
| ToString() |
Devuelve una representación de cadena del objeto . (Heredado de Object) |
| UnregisterFromRuntime() |
Anula el registro de este Java del mismo nivel del tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| Wait() |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser em notificado/em< o >em<interrumpido>/em<.><> (Heredado de Object) |
| Wait(Int64, Int32) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
| Wait(Int64) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
| WritePendingIntentOrNullToParcel(PendingIntent, Parcel) |
Función de conveniencia para escribir un puntero PendingIntent o null en un paquete. |
| WriteToParcel(Parcel, ParcelableWriteFlags) |
Aplane este objeto en un paquete. |
Implementaciones de interfaz explícitas
| Nombre | Description |
|---|---|
| IJavaPeerable.Disposed() |
Descripción de una acción Intención y destino que se va a realizar con ella. (Heredado de JavaObject) |
| IJavaPeerable.Finalized() |
Descripción de una acción Intención y destino que se va a realizar con ella. (Heredado de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Descripción de una acción Intención y destino que se va a realizar con ella. (Heredado de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Descripción de una acción Intención y destino que se va a realizar con ella. (Heredado de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Descripción de una acción Intención y destino que se va a realizar con ella. (Heredado de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Descripción de una acción Intención y destino que se va a realizar con ella. (Heredado de JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
Descripción de una acción Intención y destino que se va a realizar con ella. |
Métodos de extensión
| Nombre | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtiene el nombre JNI del tipo de la instancia |
| JavaAs<TResult>(IJavaPeerable) |
Intente coerción |
| JavaCast<TResult>(IJavaObject) |
Realiza una conversión de tipos comprobados en tiempo de ejecución de Android. |
| JavaCast<TResult>(IJavaObject) |
Descripción de una acción Intención y destino que se va a realizar con ella. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Intente coerción |