- Syntaxe :
<category android:name="string" />
- Contenu dans :
<intent-filter>
- Description :
- Ajoute un nom de catégorie à un filtre d'intent. Pour en savoir plus sur les filtres d'intent et le rôle des spécifications de catégorie dans un filtre, consultez la page Intents et filtres d'intent.
- attributs :
android:name
- Nom de la catégorie. Les catégories standards sont définies dans la classe
Intent
en tant que constantesCATEGORY_name
. Le nom attribué ici est dérivé de ces constantes en ajoutant le préfixeandroid.intent.category.
au préfixename
qui suitCATEGORY_
. Par exemple, la valeur de la chaîne pourCATEGORY_LAUNCHER
estandroid.intent.category.LAUNCHER
.Remarque : Pour recevoir des intents implicites, vous devez inclure la catégorie
CATEGORY_DEFAULT
dans le filtre d'intent. Les méthodesstartActivity()
etstartActivityForResult()
traitent tous les intents comme s'ils avaient déclaré la catégorieCATEGORY_DEFAULT
. Si vous ne la déclarez pas dans votre filtre d'intent, aucun intent implicite n'atteindra votre activité.Pour les catégories personnalisées, utilisez le nom du package comme préfixe pour qu'elles soient uniques.
- Première apparition :
- Niveau d'API 1
- Voir aussi :
<action>
<data>
<catégorie>
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/27 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/27 (UTC)."],[],[],null,["# <category\u003e\n\nsyntax:\n:\n\n ```xml\n \u003ccategory android:name=\"string\" /\u003e\n ```\n\ncontained in:\n: [\u003cintent-filter\u003e](/guide/topics/manifest/intent-filter-element)\n\ndescription:\n: Adds a category name to an intent filter. See\n [Intents and\n Intent Filters](/guide/components/intents-filters) for details on intent filters and the role of category\n specifications within a filter.\n\nattributes:\n:\n\n `android:name`\n : The name of the category. Standard categories are defined in the\n [Intent](/reference/android/content/Intent) class as `CATEGORY_`*name*\n constants. The name assigned here is derived from those constants\n by prefixing `android.intent.category.` to the\n *name* that follows `CATEGORY_`. For example,\n the string value for `CATEGORY_LAUNCHER` is\n `android.intent.category.LAUNCHER`.\n\n **Note:** To receive implicit intents, you must include the\n [CATEGORY_DEFAULT](/reference/android/content/Intent#CATEGORY_DEFAULT) category in the intent filter. The methods\n [startActivity()](/reference/android/app/Activity#startActivity(android.content.Intent)) and\n [startActivityForResult()](/reference/android/app/Activity#startActivityForResult(android.content.Intent, int)) treat all intents\n as if they declared the [CATEGORY_DEFAULT](/reference/android/content/Intent#CATEGORY_DEFAULT) category.\n If you don't declare it in your intent filter, no implicit intents can resolve\n your activity.\n\n\n For custom categories, use the package name as a prefix so\n that they are unique.\n\nintroduced in:\n: API Level 1\n\nsee also:\n: [\u003caction\u003e](/guide/topics/manifest/action-element)\n\n [\u003cdata\u003e](/guide/topics/manifest/data-element)"]]