ActivityFlags Enumeración
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í.
Enumera los valores devueltos por varios tipos y tomados como parámetro de varios tipos.
Esta enumeración admite una combinación bit a bit de sus valores de miembro.
[System.Flags]
public enum ActivityFlags
[<System.Flags>]
type ActivityFlags =
- Herencia
-
ActivityFlags
- Atributos
Campos
| Nombre | Valor | Description |
|---|---|---|
| GrantReadUriPermission | 1 | Si se establece, al destinatario de esta intención se le concederá permiso para realizar operaciones de lectura en el URI en los datos de la intención y los URI especificados en su ClipData. |
| GrantWriteUriPermission | 2 | Si se establece, al destinatario de esta intención se le concederá permiso para realizar operaciones de escritura en el URI en los datos de la intención y los URI especificados en su ClipData. |
| FromBackground | 4 | El autor de la llamada puede establecerlo para indicar que esta intención procede de una operación en segundo plano, no de la interacción directa del usuario. |
| DebugLogResolution | 8 | Una marca que puede habilitar para la depuración: cuando se establece, los mensajes de registro se imprimirán durante la resolución de esta intención para mostrar lo que se ha encontrado para crear la lista resuelta final. |
| ExcludeStoppedPackages | 16 | Si se establece, esta intención no coincidirá con los componentes de los paquetes que están detenidos actualmente. |
| IncludeStoppedPackages | 32 | Si se establece, esta intención siempre coincidirá con los componentes de los paquetes que están detenidos actualmente. |
| GrantPersistableUriPermission | 64 | Cuando se combina con FLAG_GRANT_READ_URI_PERMISSION y/o FLAG_GRANT_WRITE_URI_PERMISSION , la concesión de permisos de URI se puede conservar en los reinicios del dispositivo hasta que se revoque explícitamente con Context.revokeUriPermission(Uri,int). Esta marca solo ofrece la concesión para la posible conservación; La aplicación receptora debe llamar a ContentResolver.takePersistableUriPermission(Uri,int) para que persista realmente. |
| GrantPrefixUriPermission | 128 | Cuando se combina con FLAG_GRANT_READ_URI_PERMISSION o FLAG_GRANT_WRITE_URI_PERMISSION , la concesión de permisos de URI se aplica a cualquier URI que sea una coincidencia de prefijo con el URI concedido original. (Sin esta marca, el URI debe coincidir exactamente para que se conceda acceso). Otro URI se considera una coincidencia de prefijo solo cuando el esquema, la autoridad y todos los segmentos de ruta definidos por el prefijo son una coincidencia exacta. |
| DirectBootAuto | 256 | Marca que se usa para buscar coincidencias automáticas con las intenciones en función de su reconocimiento del arranque directo y el estado actual del usuario. Dado que el comportamiento predeterminado es aplicar automáticamente el estado de usuario actual, se trata de un valor centinela que no cambia la salida de ninguna consulta en función de su presencia o ausencia. En su lugar, este valor puede ser útil junto con StrictMode.VmPolicy.Builder.detectImplicitDirectBoot() para detectar cuándo un autor de la llamada se basa en la coincidencia automática implícita, en lugar de confirmar el comportamiento explícito que desean. Valor constante: 256 (0x00000100) |
| RequireDefault | 512 | Si se establece en una intención pasada a Context.startActivity(), esta marca solo iniciará la intención si se resuelve en un único resultado. Si no existe este resultado o si el selector del sistema se mostraría de otro modo, se producirá una excepción ActivityNotFoundException. |
| RequireNonBrowser | 1024 | Si se establece en una intención pasada a Context.startActivity(), esta marca solo iniciará la intención si se resuelve en un resultado que no es un explorador. Si no existe este resultado, se producirá una excepción ActivityNotFoundException. |
| MatchExternal | 2048 | Si se establece en una intención pasada a Context.startActivity(), esta marca intentará iniciar una aplicación instantánea si no hay ninguna aplicación completa en el dispositivo que ya pueda controlar la intención. Al intentar resolver aplicaciones instantáneas externamente, se admiten las siguientes propiedades Intent: Intent.setAction(String) Intent.addCategory(String) Intent.setData(Uri) Intent.setType(String). setPackage(String) Intent.addFlags(int) En caso de que no se encuentre ninguna aplicación instantánea, el instalador se iniciará para notificar al usuario que no se pudo resolver la intención. En los dispositivos que no admiten aplicaciones instantáneas, se omitirá la marca. Valor constante: 2048 (0x00000800) |
| LaunchAdjacent | 4096 | Esta marca solo se usa para el modo de varias ventanas de pantalla dividida. La nueva actividad se mostrará junto a la que lo inicia si es posible. Esto solo se puede usar junto con FLAG_ACTIVITY_NEW_TASK . Además, se requiere establecer FLAG_ACTIVITY_MULTIPLE_TASK si desea crear una nueva instancia de una actividad existente. |
| RetainInRecents | 8192 | De forma predeterminada, un documento creado por FLAG_ACTIVITY_NEW_DOCUMENT tendrá su entrada en las tareas recientes quitadas cuando el usuario lo cierre (con atrás o, sin embargo, puede finalizar)). Si en su lugar desea permitir que el documento se conserve en recientes para que se pueda volver a iniciar, puede usar esta marca. Cuando se haya establecido y finalizada la actividad de la tarea, la entrada recents permanecerá en la interfaz para que el usuario vuelva a iniciarla, como una entrada de reciente para una aplicación de nivel superior. La actividad receptora puede invalidar esta solicitud con R.attr.autoRemoveFromRecents o llamando explcitly a Activity.finishAndRemoveTask() . |
| TaskOnHome | 16384 | Si se establece en una intención pasada a Context.startActivity(), esta marca hará que una tarea de inicio recién se coloque en la parte superior de la tarea de actividad principal actual (si hay una). Es decir, al presionar atrás de la tarea siempre se devolverá el usuario a casa aunque no fuera la última actividad que vio. Esto solo se puede usar junto con FLAG_ACTIVITY_NEW_TASK . |
| ClearTask | 32768 | Si se establece en una intención pasada a Context.startActivity(), esta marca hará que cualquier tarea existente asociada a la actividad se borre antes de que se inicie la actividad. Es decir, la actividad se convierte en la nueva raíz de una tarea vacía de lo contrario y se finalizan las actividades antiguas. Esto solo se puede usar junto con FLAG_ACTIVITY_NEW_TASK . |
| NoAnimation | 65536 | Si se establece en una intención pasada a Context.startActivity(), esta marca impedirá que el sistema aplique una animación de transición de actividad para ir al siguiente estado de actividad. Esto no significa que nunca se ejecute una animación; si se produce otro cambio de actividad que no especifica esta marca antes de que se muestre la actividad iniciada aquí, se usará esa transición. Esta marca se puede poner en buen uso cuando vaya a realizar una serie de operaciones de actividad, pero la animación vista por el usuario no debe estar controlada por el primer cambio de actividad, sino una posterior. |
| ReorderToFront | 131072 | Si se establece en una intención pasada a Context.startActivity(), esta marca hará que la actividad iniciada se presente al principio de la pila de historial de su tarea si ya se está ejecutando. Por ejemplo, considere una tarea que consta de cuatro actividades: A, B, C, D. Si D llama a startActivity() con una intención que se resuelve en el componente de la actividad B, B se llevará al principio de la pila del historial, con este orden resultante: A, C, D, B. Esta marca se omitirá si también se especifica FLAG_ACTIVITY_CLEAR_TOP. |
| NoUserAction | 262144 | Si se establece, esta marca impedirá que la devolución de llamada normal Activity.onUserLeaveHint() se produzca en la actividad front-end actual antes de que se detenga cuando se ponga en marcha la actividad recién iniciada. Normalmente, una actividad puede depender de esa devolución de llamada para indicar que una acción explícita del usuario ha provocado que su actividad se mueva fuera del primer plano. La devolución de llamada marca un punto adecuado en el ciclo de vida de la actividad para que descarte las notificaciones que pretende mostrar "hasta que el usuario las haya visto", como un LED parpadeante. Si alguna vez se inicia una actividad a través de eventos no controlados por el usuario, como la recepción de llamadas telefónicas o un controlador de alarma, esta marca debe pasarse a Context.startActivity , asegurándose de que la actividad de pausa no cree que el usuario haya confirmado su notificación. Valor constante: 262144 (0x00040000) |
| ClearWhenTaskReset | 524288 | Esta constante estaba en desuso en el nivel de API 21. A partir de la API 21, esto realiza de forma idéntica a FLAG_ACTIVITY_NEW_DOCUMENT que se debe usar en lugar de esto. |
| NewDocument | 524288 | Esta marca se usa para abrir un documento en una nueva tarea raíz en la actividad iniciada por esta intención. A través del uso de esta marca, o su atributo equivalente, R.attr.documentLaunchMode varias instancias de la misma actividad que contiene documentos diferentes aparecerán en la lista de tareas recientes. El uso del atributo activity de esta forma, R.attr.documentLaunchMode, es preferible sobre la marca Intent que se describe aquí. El formulario de atributo permite a la actividad especificar varios comportamientos de documento para todos los iniciadores de la actividad, mientras que el uso de esta marca requiere cada intención que inicie la actividad para especificarlo. Tenga en cuenta que la semántica predeterminada de esta marca w.r.t. si la entrada de recientes para ella se mantiene una vez finalizada la actividad es diferente del uso de FLAG_ACTIVITY_NEW_TASK y R.attr.documentLaunchMode, si se usa esta marca para crear una nueva entrada de recientes, de forma predeterminada esa entrada se quitará una vez finalizada la actividad. Puede modificar este comportamiento con FLAG_ACTIVITY_RETAIN_IN_RECENTS . FLAG_ACTIVITY_NEW_DOCUMENT se pueden usar junto con FLAG_ACTIVITY_MULTIPLE_TASK . Cuando se usa solo, es el equivalente del manifiesto de actividad que especifica R.attr.documentLaunchMode ="intoExisting". Cuando se usa con FLAG_ACTIVITY_MULTIPLE_TASK es el equivalente del manifiesto de actividad que especifica R.attr.documentLaunchMode ="always". La marca se omite incluso junto con FLAG_ACTIVITY_MULTIPLE_TASK cuando el manifiesto de actividad especifica R.attr.documentLaunchMode ="never". Consulte R.attr.documentLaunchMode para obtener más información. Vea también: R.attr.documentLaunchMode FLAG_ACTIVITY_MULTIPLE_TASK Valor constante: 524288 (0x00080000) |
| LaunchedFromHistory | 1048576 | Este indicador no se establece normalmente mediante código de aplicación, pero se establece automáticamente por el sistema si se inicia esta actividad desde el historial (clave principal de longpress). |
| ReceiverVisibleToInstantApps | 2097152 | Si se establece, la difusión será visible para los receptores en Aplicaciones instantáneas. De forma predeterminada, Instant Apps no recibirá difusión. Esta marca no tiene ningún efecto cuando se usa en una aplicación instantánea. |
| ResetTaskIfNeeded | 2097152 | Si se establece y esta actividad se inicia en una nueva tarea o se lleva a la parte superior de una tarea existente, se iniciará como puerta frontal de la tarea. |
| BroughtToFront | 4194304 | Este indicador no se establece normalmente mediante el código de la aplicación, pero el sistema lo establece como se describe en la documentación launchMode para el modo singleTask. |
| ExcludeFromRecents | 8388608 | Si se establece, la nueva actividad no se mantiene en la lista de actividades iniciadas recientemente. |
| PreviousIsTop | 16777216 | Si se establece y esta intención se usa para iniciar una nueva actividad desde una existente, la actividad actual no se contará como la actividad principal para decidir si la nueva intención debe entregarse al principio en lugar de iniciar una nueva. La actividad anterior se usará como parte superior, con la suposición de que la actividad actual se finalizará inmediatamente. |
| ForwardResult | 33554432 | Si se establece y esta intención se usa para iniciar una nueva actividad desde una existente, el destino de respuesta de la actividad existente se transferirá a la nueva actividad. |
| ClearTop | 67108864 | Si se establece y la actividad que se inicia ya se está ejecutando en la tarea actual, en lugar de iniciar una nueva instancia de esa actividad, se cerrarán todas las demás actividades en la parte superior y esta intención se entregará a la actividad anterior (ahora en la parte superior) anterior como una nueva intención. Por ejemplo, considere una tarea que consta de las actividades: A, B, C, D. Si D llama a startActivity() con una intención que se resuelve en el componente de la actividad B, C y D se finalizarán y B recibirán la intención dada, lo que da lugar a que la pila ahora sea: A, B. La instancia que se está ejecutando actualmente de la actividad B en el ejemplo anterior recibirá la nueva intención que está empezando aquí en su método onNewIntent() o bien se finalizará y reiniciará con la nueva intención. Si ha declarado su modo de inicio para ser "múltiplo" (el valor predeterminado) y no ha establecido FLAG_ACTIVITY_SINGLE_TOP en la misma intención, se finalizará y se volverá a crear; para todos los demás modos de inicio o si se establece FLAG_ACTIVITY_SINGLE_TOP, esta intención se entregará a la instancia actual onNewIntent(). Este modo de inicio también se puede usar para tener un buen efecto junto con FLAG_ACTIVITY_NEW_TASK : si se usa para iniciar la actividad raíz de una tarea, llevará cualquier instancia actualmente en ejecución de esa tarea al primer plano y, a continuación, lo borrará en su estado raíz. Esto es especialmente útil, por ejemplo, al iniciar una actividad desde el administrador de notificaciones. Consulte Tareas y pila trasera para obtener más información sobre las tareas. Valor constante: 67108864 (0x04000000) |
| MultipleTask | 134217728 | No use esta marca a menos que implemente su propio iniciador de aplicaciones de nivel superior.NewTasksiempre Dado que el sistema predeterminado no incluye la administración gráfica de tareas, no debe usar esta marca a menos que proporcione alguna manera para que un usuario vuelva a las tareas que ha iniciado. Consulte Tareas y pila trasera para obtener más información sobre las tareas. |
| ReceiverNoAbort | 134217728 | Si se trata de una difusión ordenada, no permita que los receptores anulen la difusión. Todavía pueden propagar los resultados a través de receptores posteriores, pero no pueden impedir que los receptores posteriores vean la difusión. |
| NewTask | 268435456 | Si se establece, esta actividad se convertirá en el inicio de una nueva tarea en esta pila de historial. Una tarea (de la actividad que la inició a la siguiente actividad de tarea) define un grupo atómico de actividades a las que el usuario puede moverse. Las tareas se pueden mover al primer plano y al fondo; todas las actividades dentro de una tarea determinada siempre permanecen en el mismo orden. Consulte Tareas y pila trasera para obtener más información sobre las tareas. Normalmente, esta marca se usa en las actividades que quieren presentar un comportamiento de estilo de "iniciador": proporcionan al usuario una lista de cosas independientes que se pueden hacer, que de lo contrario se ejecutan completamente independientemente de la actividad que los inicia. Al usar esta marca, si ya se está ejecutando una tarea para la actividad que está iniciando, no se iniciará una nueva actividad; en su lugar, la tarea actual simplemente se llevará a la parte frontal de la pantalla con el estado en el que se encontraba por última vez. Consulte FLAG_ACTIVITY_MULTIPLE_TASK para obtener una marca para deshabilitar este comportamiento. Esta marca no se puede usar cuando el autor de la llamada solicita un resultado de la actividad que se está iniciando. Valor constante: 268435456 (0x10000000) |
| ReceiverForeground | 268435456 | Si se establece, al enviar una difusión, el destinatario puede ejecutarse con prioridad de primer plano, con un intervalo de tiempo de espera más corto. |
| ReceiverReplacePending | 536870912 | Si se establece, al enviar una difusión, la nueva difusión reemplazará cualquier difusión pendiente existente que coincida con ella. La coincidencia se define mediante Intent.filterEquals que devuelve true para las intenciones de las dos difusión. Cuando se encuentra una coincidencia, la nueva difusión (y los receptores asociados a ella) reemplazarán la existente en la lista de difusión pendiente y permanecerán en la misma posición de la lista. Esta marca se usa normalmente con difusión pegajosa, que solo se preocupa por entregar los valores más recientes de la difusión a sus receptores. |
| SingleTop | 536870912 | Si se establece, la actividad no se iniciará si ya se está ejecutando en la parte superior de la pila del historial. |
| NoHistory | 1073741824 | Si se establece, la nueva actividad no se mantiene en la pila del historial. |
| ReceiverRegisteredOnly | 1073741824 | Si se establece, al enviar una difusión solo se llamará a los receptores registrados; no se iniciará ningún componente broadcastReceiver. |
Comentarios
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.