ActivityFlags Énumération

Si elle est définie, le destinataire de cette intention est autorisé à effectuer des opérations de lecture sur l’URI dans les données de l’intention et les URI spécifiés dans son ClipData.

Si elle est définie, le destinataire de cette intention est autorisé à effectuer des opérations d’écriture sur l’URI dans les données de l’intention et les URI spécifiés dans son ClipData.

Peut être défini par l’appelant pour indiquer que cette intention provient d’une opération en arrière-plan, et non d’une interaction directe de l’utilisateur.

Indicateur que vous pouvez activer pour le débogage : lorsque vous définissez, les messages de journal seront imprimés pendant la résolution de cette intention pour vous montrer ce qui a été trouvé pour créer la liste résolue finale.

Si elle est définie, cette intention ne correspond à aucun composant des packages actuellement arrêtés.

Si elle est définie, cette intention correspond toujours aux composants des packages actuellement arrêtés.

En cas de combinaison avec FLAG_GRANT_READ_URI_PERMISSION et/ou FLAG_GRANT_WRITE_URI_PERMISSION, l’octroi d’autorisation d’URI peut être conservé entre les redémarrages de l’appareil jusqu’à ce qu’il soit explicitement révoqué avec Context.revokeUriPermission(Uri,int). Cet indicateur offre uniquement l’octroi pour la persistance possible ; l’application de réception doit appeler ContentResolver.takePersistableUriPermission(Uri,int) pour conserver réellement.

En cas de combinaison avec FLAG_GRANT_READ_URI_PERMISSION et/ou FLAG_GRANT_WRITE_URI_PERMISSION, l’octroi d’autorisation d’URI s’applique à tout URI correspondant à un préfixe correspondant à l’URI accordé d’origine. (Sans cet indicateur, l’URI doit correspondre exactement pour que l’accès soit accordé.) Un autre URI est considéré comme une correspondance de préfixe uniquement lorsque le schéma, l’autorité et tous les segments de chemin définis par le préfixe sont une correspondance exacte.

Indicateur utilisé pour faire correspondre automatiquement les intentions en fonction de leur sensibilisation au démarrage direct et de l’état actuel de l’utilisateur. Étant donné que le comportement par défaut consiste à appliquer automatiquement l’état utilisateur actuel, il s’agit effectivement d’une valeur sentinelle qui ne modifie pas la sortie des requêtes en fonction de sa présence ou de son absence. Au lieu de cela, cette valeur peut être utile conjointement avec StrictMode.VmPolicy.Builder.detectImplicitDirectBoot() pour détecter lorsqu’un appelant s’appuie sur une correspondance automatique implicite, au lieu de confirmer le comportement explicite souhaité. Valeur constante : 256 (0x00000100)

Si elle est définie dans une intention passée à Context.startActivity(), cet indicateur lance uniquement l’intention si elle se résout en un seul résultat. S’il n’existe aucun résultat de ce type ou si le sélecteur système s’affiche autrement, une exception ActivityNotFoundException est levée.

Si elle est définie dans une intention passée à Context.startActivity(), cet indicateur lance uniquement l’intention si elle se résout en un résultat qui n’est pas un navigateur. S’il n’existe aucun résultat de ce type, une exception ActivityNotFoundException est levée.

Si elle est définie dans une intention passée à Context.startActivity(), cet indicateur tente de lancer une application instantanée si aucune application complète sur l’appareil ne peut déjà gérer l’intention. Lorsque vous tentez de résoudre des applications instantanées en externe, les propriétés intention suivantes sont prises en charge : Intent.setAction(String) Intent.addCategory(String) Intent.setData(Uri) Intent.setType(String) Intent.addFlags(int) Dans le cas où aucune application instantanée n’est disponible, le programme d’installation sera lancé pour avertir l’utilisateur que l’intention n’a pas pu être résolue. Sur les appareils qui ne prennent pas en charge les applications instantanées, l’indicateur est ignoré. Valeur constante : 2048 (0x00000800)

Cet indicateur est utilisé uniquement pour le mode multi-fenêtre à écran fractionné. La nouvelle activité s’affiche à côté de celle qui la lance si possible. Cela ne peut être utilisé que conjointement avec FLAG_ACTIVITY_NEW_TASK . En outre, la définition de FLAG_ACTIVITY_MULTIPLE_TASK est requise si vous souhaitez créer une nouvelle instance d’une activité existante.

Par défaut, un document créé par FLAG_ACTIVITY_NEW_DOCUMENT aura son entrée dans les tâches récentes supprimées lorsque l’utilisateur le ferme (avec le dos ou, toutefois, il peut se terminer()). Si vous souhaitez à la place autoriser le document à conserver dans des versions récentes afin qu’il puisse être redéployé, vous pouvez utiliser cet indicateur. Lorsque l’activité de la tâche est définie et terminée, l’entrée récente reste dans l’interface de l’utilisateur pour la relancer, comme une entrée récente pour une application de niveau supérieur. L’activité de réception peut remplacer cette requête par R.attr.autoRemoveFromRecents ou par appeler activity.finishAndRemoveTask() .

Si elle est définie dans une intention passée à Context.startActivity(), cet indicateur entraîne la mise en place d’une tâche nouvellement lancée au-dessus de la tâche d’activité d’accueil actuelle (s’il en existe un). Autrement dit, la pression de retour de la tâche renvoie toujours l’utilisateur à la maison même si ce n’était pas la dernière activité qu’il a vue. Cela ne peut être utilisé que conjointement avec FLAG_ACTIVITY_NEW_TASK .

Si elle est définie dans une intention passée à Context.startActivity(), cet indicateur entraîne l’effacement de toute tâche existante associée à l’activité avant le démarrage de l’activité. Autrement dit, l’activité devient la nouvelle racine d’une tâche vide autrement, et toutes les anciennes activités sont terminées. Cela ne peut être utilisé que conjointement avec FLAG_ACTIVITY_NEW_TASK .

Si cette option est définie dans une intention passée à Context.startActivity(), cet indicateur empêche le système d’appliquer une animation de transition d’activité pour accéder à l’état d’activité suivant. Cela ne signifie pas qu’une animation ne s’exécutera jamais. Si une autre modification d’activité ne spécifie pas cet indicateur avant que l’activité ne démarre ici est affichée, cette transition sera utilisée. Cet indicateur peut être mis à profit lorsque vous allez effectuer une série d’opérations d’activité, mais l’animation vue par l’utilisateur ne doit pas être pilotée par la première modification d’activité, mais plutôt une autre.

Si elle est définie dans une intention passée à Context.startActivity(), cet indicateur entraîne l’entrée de l’activité lancée à l’avant de la pile d’historique de sa tâche s’il est déjà en cours d’exécution. Par exemple, considérez une tâche composée de quatre activités : A, B, C, D. Si D appelle startActivity() avec une intention qui se résout au composant de l’activité B, B est amené à l’avant de la pile d’historiques, avec cet ordre résultant : A, C, D, B. Cet indicateur est ignoré si FLAG_ACTIVITY_CLEAR_TOP est également spécifié.

S’il est défini, cet indicateur empêche le rappel Activity.onUserLeaveHint() normal de se produire sur l’activité frontale actuelle avant qu’il ne soit suspendu lorsque l’activité nouvellement démarrée est mise en avant. En règle générale, une activité peut s’appuyer sur ce rappel pour indiquer qu’une action explicite de l’utilisateur a provoqué le déplacement de son activité hors du premier plan. Le rappel marque un point approprié dans le cycle de vie de l’activité pour qu’il ignore toutes les notifications qu’il a l’intention d’afficher « jusqu’à ce que l’utilisateur les ait vues », comme une LED clignolante. Si une activité est jamais démarrée par le biais d’événements non pilotés par l’utilisateur tels que le reçu par téléphone ou un gestionnaire d’alarmes, cet indicateur doit être transmis à Context.startActivity, ce qui garantit que l’activité de suspension ne pense pas que l’utilisateur a reconnu sa notification. Valeur constante : 262144 (0x00040000)

Cette constante a été déconseillée au niveau de l’API 21. À partir de l’API 21, cette opération est identique à FLAG_ACTIVITY_NEW_DOCUMENT qui doit être utilisée au lieu de cela.

Cet indicateur permet d’ouvrir un document dans une nouvelle tâche enracinée dans l’activité lancée par cette intention. Grâce à l’utilisation de cet indicateur ou de son attribut équivalent, R.attr.documentLaunchMode plusieurs instances de la même activité contenant différents documents apparaîtront dans la liste des tâches récentes. L’utilisation de la forme d’attribut d’activité de ce R.attr.documentLaunchMode est préférée à l’indicateur Intention décrit ici. Le formulaire d’attribut permet à l’activité de spécifier plusieurs comportements de document pour tous les lanceurs de l’activité, tandis que l’utilisation de cet indicateur nécessite chaque intention qui lance l’activité pour la spécifier. Notez que la sémantique par défaut de cet indicateur w.r.t. indique si l’entrée récente est conservée une fois l’activité terminée est différente de l’utilisation de FLAG_ACTIVITY_NEW_TASK et R.attr.documentLaunchMode . Si cet indicateur est utilisé pour créer une entrée récente, cette entrée sera supprimée par défaut une fois l’activité terminée. Vous pouvez modifier ce comportement avec FLAG_ACTIVITY_RETAIN_IN_RECENTS . FLAG_ACTIVITY_NEW_DOCUMENT peut être utilisé conjointement avec FLAG_ACTIVITY_MULTIPLE_TASK . Lorsqu’il est utilisé seul, il est l’équivalent du manifeste d’activité spécifiant R.attr.documentLaunchMode ="intoExisting ». Lorsqu’elle est utilisée avec FLAG_ACTIVITY_MULTIPLE_TASK il s’agit de l’équivalent du manifeste d’activité spécifiant R.attr.documentLaunchMode ="always ». L’indicateur est ignoré même conjointement avec FLAG_ACTIVITY_MULTIPLE_TASK lorsque le manifeste d’activité spécifie R.attr.documentLaunchMode ="never ». Pour plus d’informations, reportez-vous à R.attr.documentLaunchMode. Voir aussi : R.attr.documentLaunchMode FLAG_ACTIVITY_MULTIPLE_TASK valeur constante : 524288 (0x00080000)

Cet indicateur n’est pas normalement défini par le code de l’application, mais défini pour vous par le système si cette activité est lancée à partir de l’historique (clé d’accueil longpress).

Si elle est définie, la diffusion est visible pour les récepteurs dans Les applications instantanées. Par défaut, les applications instantanées ne reçoivent pas de diffusions. Cet indicateur n’a aucun effet lorsqu’il est utilisé par une application instantanée.

Si elle est définie et que cette activité est démarrée dans une nouvelle tâche ou qu’elle s’affiche en haut d’une tâche existante, elle sera lancée comme porte d’entrée de la tâche.

Cet indicateur n’est pas normalement défini par code d’application, mais défini pour vous par le système comme décrit dans la documentation launchMode pour le mode singleTask.

Si elle est définie, la nouvelle activité n’est pas conservée dans la liste des activités récemment lancées.

Si elle est définie et que cette intention est utilisée pour lancer une nouvelle activité à partir d’une activité existante, l’activité actuelle n’est pas comptabilisée comme l’activité principale pour déterminer si la nouvelle intention doit être remise au sommet au lieu de commencer une nouvelle. L’activité précédente sera utilisée en haut, avec l’hypothèse selon laquelle l’activité actuelle se terminera immédiatement.

Si cette intention est définie et utilisée pour lancer une nouvelle activité à partir d’une activité existante, la cible de réponse de l’activité existante est transférée vers la nouvelle activité.

Si elle est définie et que l’activité en cours d’exécution est déjà en cours d’exécution dans la tâche actuelle, au lieu de lancer une nouvelle instance de cette activité, toutes les autres activités sont fermées et cette intention est remise à l’ancienne activité (maintenant en haut) en tant que nouvelle intention. Par exemple, considérez une tâche composée des activités : A, B, C, D. Si D appelle startActivity() avec une intention qui se résout au composant de l’activité B, C et D sont terminés et B reçoivent l’intention donnée, ce qui entraîne l’exécution de la pile : A, B. L’instance en cours d’exécution de l’activité B dans l’exemple ci-dessus reçoit la nouvelle intention que vous démarrez ici dans sa méthode onNewIntent(), ou elle-même terminée et redémarrée avec la nouvelle intention. S’il a déclaré que son mode de lancement est « multiple » (valeur par défaut) et que vous n’avez pas défini FLAG_ACTIVITY_SINGLE_TOP dans la même intention, il sera terminé et recréé ; pour tous les autres modes de lancement ou si FLAG_ACTIVITY_SINGLE_TOP est défini, cette intention est remise à l’instance actuelle surNewIntent(). Ce mode de lancement peut également être utilisé pour un bon effet conjointement avec FLAG_ACTIVITY_NEW_TASK : s’il est utilisé pour démarrer l’activité racine d’une tâche, il amène toute instance en cours d’exécution de cette tâche au premier plan, puis l’efface à son état racine. Cela est particulièrement utile, par exemple, lors du lancement d’une activité à partir du gestionnaire de notifications. Pour plus d’informations sur les tâches, consultez Tasks and Back Stack. Valeur constante : 67108864 (0x04000000)

N’utilisez pas cet indicateur, sauf si vous implémentez votre propre lanceur d’applications de niveau supérieur.NewTasktoujours

Étant donné que le système par défaut n’inclut pas la gestion des tâches graphiques, vous ne devez pas utiliser cet indicateur, sauf si vous fournissez un moyen à un utilisateur de revenir aux tâches que vous avez lancées.

NewTask

Pour plus d’informations sur les tâches , consultez Tasks and Back Stack .

S’il s’agit d’une diffusion ordonnée, n’autorisez pas les récepteurs à abandonner la diffusion. Ils peuvent toujours propager les résultats à des récepteurs ultérieurs, mais ils ne peuvent pas empêcher les récepteurs ultérieurs de voir la diffusion.

Si elle est définie, cette activité devient le début d’une nouvelle tâche sur cette pile d’historiques. Une tâche (de l’activité qui l’a démarrée à l’activité de tâche suivante) définit un groupe atomique d’activités vers lequel l’utilisateur peut passer. Les tâches peuvent être déplacées au premier plan et en arrière-plan ; toutes les activités à l’intérieur d’une tâche particulière restent toujours dans le même ordre. Pour plus d’informations sur les tâches, consultez Tasks and Back Stack. Cet indicateur est généralement utilisé par les activités qui souhaitent présenter un comportement de style « lanceur » : ils donnent à l’utilisateur une liste de choses distinctes qui peuvent être effectuées, qui s’exécutent autrement complètement indépendamment de l’activité qui les lance. Lorsque vous utilisez cet indicateur, si une tâche est déjà en cours d’exécution pour l’activité que vous démarrez, une nouvelle activité ne sera pas démarrée ; Au lieu de cela, la tâche actuelle sera simplement apportée à l’avant de l’écran avec l’état dans lequel elle était dernière. Consultez FLAG_ACTIVITY_MULTIPLE_TASK d’un indicateur pour désactiver ce comportement. Cet indicateur ne peut pas être utilisé lorsque l’appelant demande un résultat de l’activité lancée. Valeur constante : 268435456 (0x10000000)

Si cette option est définie, lors de l’envoi d’une diffusion, le destinataire est autorisé à s’exécuter au premier plan, avec un intervalle de délai d’expiration plus court.

Si elle est définie, lors de l’envoi d’une diffusion, la nouvelle diffusion remplace toute diffusion en attente existante qui la correspond. La correspondance est définie par Intent.filterEquals retournant true pour les intentions des deux diffusions. Lorsqu’une correspondance est trouvée, la nouvelle diffusion (et les récepteurs associés à celui-ci) remplace celle existante dans la liste de diffusion en attente, restant à la même position dans la liste. Cet indicateur est généralement utilisé avec des diffusions collantes, qui s’intéressent uniquement à la remise des valeurs les plus récentes de la diffusion à leurs récepteurs.

Si elle est définie, l’activité ne sera pas lancée si elle est déjà en cours d’exécution en haut de la pile d’historique.

Si elle est définie, la nouvelle activité n’est pas conservée dans la pile d’historique.

Si cette option est définie, lors de l’envoi d’un récepteur inscrit uniquement, aucun composant BroadcastReceiver n’est lancé.