<property>
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
- بناء الجملة:
<property android:name="string"
android:resource="resource specification"
android:value="string" />- الواردة في:
<activity>
<activity-alias>
<application>
<provider>
<receiver>
<service>
- description:
- يشير إلى زوج من الاسم والقيمة لعنصر من البيانات الإضافية العشوائية التي يمكن تقديمها إلى
المكون الأصلي. يمكن أن يحتوي العنصر المكون على أي عدد من عناصر
<property> الفرعية. الأسماء الصالحة
تضمين أي من ثوابت الخصائص المحددة في
الفئة PackageManager،
تم تحديد علامات PackageManager.Property
في فئات مثل WindowProperties، والثوابت العشوائية المحددة الخاصة. الحصول على القيم بشكل فردي باستخدام
طريقة
PackageManager.getProperty().
حدِّد قيمًا عادية باستخدام السمة android:value
. حدِّد معرّفات الموارد باستخدام
android:resource. التحديد
كل من android:value وandroid:resource غير صالح.
على سبيل المثال، يعيّن الرمز التالي أي قيمة مخزّنة في مورد @string/kangaroo إلى
اسم zoo:
<property android:name="zoo" android:value=”@string/kangaroo” />
ومع ذلك، يعيّن الرمز هنا المعرف الرقمي للمورد، وليس القيمة المخزنة في المورد، إلى
zoo:
<property android:name="zoo" android:resource=”@string/kangaroo” />
- :
android:name- اسم المكان المخصّص للاستئجار. تظهر نتائج خطأ في التحليل إذا كانت علامات
<property> المتعددة التابعة لها العلامة
بالاسم نفسه.
android:resource- إشارة إلى مورد معرِّف المورد هو القيمة المخصّصة للموقع. يمكن استرداد المعرّف
من العقار من خلال
PackageManager.Property.getResourceId()
android:value- قيمة تم تخصيصها للموقع. يسرد الجدول التالي أنواع البيانات الصالحة وطرق الموصّل للقيمة
السمة:
| النوع |
موصّل PackageManager.Property |
سلسلة: استخدِم الشرطات المائلة للخلف المزدوجة (\\) لإلغاء الأحرف. على سبيل المثال، \\n و\\uxxxxx
لحرف Unicode |
getString() |
عدد صحيح: على سبيل المثال، 100 |
getInteger() |
قيمة منطقية: إما true أو false |
getBoolean() |
اللون: بالصيغة #rgb أو #argb أو #rrggbb أو #aarrggbb |
getInteger() |
عائم: على سبيل المثال، 1.23 |
getFloat() |
ملاحظة: يجب ألا تحتوي العلامة <property> على كلٍّ من android:value
android:resource سمة. إذا حدث ذلك، يُفضَّل استخدام android:resource.
- تم تقديمها في:
- المستوى 31 من واجهة برمجة التطبيقات
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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"]]
