- Sintaxe:
<property android:name="string" android:resource="resource specification" android:value="string" />
- contido em:
<activity>
<activity-alias>
<application>
<provider>
<receiver>
<service>
- descrição:
- Um par de nome-valor para um item de dados extras e arbitrários que pode
ser fornecido ao componente pai. Um elemento de componente pode conter qualquer
quantidade de subelementos
<property>
. Os nomes válidos incluem qualquer uma das constantes de propriedade definidas na classePackageManager
. Já as tagsPackageManager.Property
são definidas em classes comoWindowProperties
e as constantes arbitrárias são definidas como ad hoc. Acesse valores individuais usando o métodoPackageManager.getProperty()
.Especifique valores comuns com o atributo
android:value
e os IDs do recurso com o atributoandroid:resource
. Especificar tanto oandroid:value
como oandroid:resource
não é válido.Por exemplo, o código abaixo atribui qualquer valor armazenado no recurso
@string/kangaroo
ao nomezoo
:<property android:name="zoo" android:value=”@string/kangaroo” />
No entanto, o código atribui ao nome "
zoo
" o ID numérico do recurso e não o valor armazenado nele:<property android:name="zoo" android:resource=”@string/kangaroo” />
- atributos:
android:name
- O nome da propriedade. Um erro de análise ocorre se houver várias tags
<property>
irmãs com o mesmo nome. android:resource
- Uma referência a um recurso. O ID do recurso é o valor atribuído
à propriedade. O ID pode ser recuperado
da propriedade por
PackageManager.Property.getResourceId()
. android:value
- Um valor atribuído à propriedade. A tabela a seguir lista os tipos de dados e métodos do acessador válidos para o atributo
de valor:
Tipo Acessador PackageManager.Property String: use barras invertidas duplas (\\) para fazer caracteres de escape. Por exemplo, use \\n
e\\uxxxxx
para um caractere Unicode.getString()
Número inteiro: por exemplo, 100
.getInteger()
Booleano: true
oufalse
.getBoolean()
Cor: no formato #rgb
,#argb
,#rrggbb
ou#aarrggbb
.getInteger()
Ponto flutuante: por exemplo, 1.23
.getFloat()
Observação: uma tag
<property>
não pode conter os atributosandroid:value
eandroid:resource
. Se isso acontecer, prefira usarandroid:resource
.- introduzido em:
- API de nível 31
<property>
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[null,null,["Última atualização 2025-07-27 UTC."],[],[],null,["# <property\u003e\n\nsyntax:\n:\n\n ```xml\n \u003cproperty android:name=\"string\"\n android:resource=\"resource specification\"\n android:value=\"string\" /\u003e\n ```\n\ncontained in:\n: [\u003cactivity\u003e](/guide/topics/manifest/activity-element)\n\n [\u003cactivity-alias\u003e](/guide/topics/manifest/activity-alias-element)\n\n [\u003capplication\u003e](/guide/topics/manifest/application-element)\n\n [\u003cprovider\u003e](/guide/topics/manifest/provider-element)\n\n [\u003creceiver\u003e](/guide/topics/manifest/receiver-element)\n\n [\u003cservice\u003e](/guide/topics/manifest/service-element)\n\ndescription:\n: A name-value pair for an item of additional, arbitrary data that can be supplied to the\n parent component. A component element can contain any number of `\u003cproperty\u003e` subelements. Valid names\n include any of the [property constants](/reference/android/content/pm/PackageManager#constants_1) defined in\n the [PackageManager](/reference/android/content/pm/PackageManager) class,\n [PackageManager.Property](/reference/android/content/pm/PackageManager.Property) tags defined\n in classes such as [WindowProperties](/reference/kotlin/androidx/window/WindowProperties), and arbitrary constants defined ad hoc. Obtain values individually using the\n [PackageManager.getProperty()](/reference/android/content/pm/PackageManager#getProperty(java.lang.String,%20java.lang.String)) method.\n\n Specify ordinary values with the [android:value](/guide/topics/manifest/property-element#val)`\n ` attribute. Specify resource IDs with the\n [android:resource](/guide/topics/manifest/property-element#rsrc) attribute. Specifying\n both `android:value` and `android:resource` is invalid.\n\n\n For example, the following code assigns whatever value is stored in the `@string/kangaroo` resource to\n the `zoo` name:\n\n\n ```xml\n \u003cproperty android:name=\"zoo\" android:value=”@string/kangaroo” /\u003e\n ```\n\n\n The code here, however, assigns the numeric ID of the resource, not the value stored in the resource, to\n `zoo`:\n\n\n ```xml\n \u003cproperty android:name=\"zoo\" android:resource=”@string/kangaroo” /\u003e\n ```\n\nattributes:\n:\n\n `android:name`\n : The name of the property. A parsing error results if multiple, sibling `\u003cproperty\u003e` tags have the\n same name.\n\n `android:resource`\n : A reference to a resource. The ID of the resource is the value assigned to the property. The ID can be retrieved\n from the property by\n [PackageManager.Property.getResourceId()](/reference/android/content/pm/PackageManager.Property#getResourceId()).\n\n `android:value`\n : A value assigned to the property. The following table lists valid data types and accessor methods for the value\n attribute: \n\n\n | Type | PackageManager.Property accessor |\n |-----------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------|\n | String: Use double backslashes (\\\\\\\\) to escape characters; for example, `\\\\n` and `\\\\uxxxxx` for a Unicode character | [getString()](/reference/android/content/pm/PackageManager.Property#getString()) |\n | Integer: For example, `100` | [getInteger()](/reference/android/content/pm/PackageManager.Property#getInteger()) |\n | Boolean: Either `true` or `false` | [getBoolean()](/reference/android/content/pm/PackageManager.Property#getBoolean()) |\n | Color: In the form `#rgb`, `#argb`, `#rrggbb`, or `#aarrggbb` | [getInteger()](/reference/android/content/pm/PackageManager.Property#getInteger()) |\n | Float: For example, `1.23` | [getFloat()](/reference/android/content/pm/PackageManager.Property#getFloat()) |\n\n\nintroduced in:\n: API Level 31"]]