تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

مورد القائمة

يحدد مورد القائمة قائمة تطبيق - قائمة خيارات أو قائمة سياق أو قائمة فرعية - والتي ويمكن تكبيره باستخدام MenuInflater.

للحصول على دليل حول استخدام القوائم، يمكنك الاطّلاع على إضافة القوائم.

مكان الملف:

res/menu/filename.xml يُستخدَم اسم الملف كمعرّف المورد

نوع بيانات الموارد المجمّعة:

مؤشر الموارد إلى مورد Menu (أو فئة فرعية)

مرجع الموارد:

في Java: R.menu.filename
في ملف XML: @[package:]menu.filename

بناء الجملة:

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:id="@[+][package:]id/resource_name"
          android:title="string"
          android:titleCondensed="string"
          android:icon="@[package:]drawable/drawable_resource_name"
          android:onClick="method name"
          android:showAsAction=["ifRoom" | "never" | "withText" | "always" | "collapseActionView"]
          android:actionLayout="@[package:]layout/layout_resource_name"
          android:actionViewClass="class name"
          android:actionProviderClass="class name"
          android:alphabeticShortcut="string"
          android:alphabeticModifiers=["META" | "CTRL" | "ALT" | "SHIFT" | "SYM" | "FUNCTION"]
          android:numericShortcut="string"
          android:numericModifiers=["META" | "CTRL" | "ALT" | "SHIFT" | "SYM" | "FUNCTION"]
          android:checkable=["true" | "false"]
          android:visible=["true" | "false"]
          android:enabled=["true" | "false"]
          android:menuCategory=["container" | "system" | "secondary" | "alternative"]
          android:orderInCategory="integer" />
    <group android:id="@[+][package:]id/resource name"
           android:checkableBehavior=["none" | "all" | "single"]
           android:visible=["true" | "false"]
           android:enabled=["true" | "false"]
           android:menuCategory=["container" | "system" | "secondary" | "alternative"]
           android:orderInCategory="integer" >
        <item />
    </group>
    <item >
        <menu>
          <item />
        </menu>
    </item>
</menu>

العناصر:

<menu>

حقل مطلوب. يجب أن تكون هذه هي العقدة الجذر. يحتوي على <item> و/أو <group> من العناصر.

السمات:

xmlns:android: مساحة اسم XML: يجب ملء هذا الحقل. تحدد مساحة اسم XML، يجب أن يكون "http://schemas.android.com/apk/res/android".

<item>

عنصر في قائمة الطعام. وقد يحتوي على العنصر <menu> (لقائمة فرعية). يجب أن تكون عنصرًا ثانويًا لعنصر <menu> أو <group>.

السمات:

android:id

رقم تعريف المورد. معرّف مورد فريد. لإنشاء معرِّف مورد جديد لهذا العنصر، استخدِم النموذج التالي: "@+id/name" تشير علامة الجمع إلى أن هذا تم إنشاؤه كـ رقم التعريف

android:title

مورد السلسلة. عنوان القائمة كمورد سلسلة أو سلسلة أولية.

android:titleCondensed

مورد السلسلة. هو عنوان مختصر كمورد سلسلة أو سلسلة أولية. هذا النمط يُستخدم العنوان في الحالات التي يكون فيها العنوان العادي طويلاً جدًا.

android:icon

مورد قابل للرسم: صورة لاستخدامها كرمز لعنصر في القائمة

android:onClick

اسم الطريقة. طريقة الاتصال عند النقر على هذا العنصر في القائمة. تشير رسالة الأشكال البيانية في النشاط على أنه عام. يقبل استخدام MenuItem باعتباره فقط، مما يشير إلى السلعة التي تم النقر عليها. تكون لهذه الطريقة الأولوية على الطريقة العادية رد الاتصال إلى onOptionsItemSelected(). يمكنك الاطّلاع على المثال في نهاية هذه الصفحة.

تحذير: في حال إخفاء مفاتيح فك تشفير الرمز باستخدام ProGuard أو أداة مشابهة، تأكد من استبعاد الطريقة التي تحددها في هذه السمة من إعادة التسمية، لأنها قد تؤدي إلى تعطيل الأخرى.

وتم تقديم هذه المقاييس في المستوى 11 من واجهة برمجة التطبيقات.

android:showAsAction

الكلمة الرئيسية. وقت وطريقة ظهور هذا العنصر كبند عمل في التطبيق الشريط. لا يمكن أن يظهر عنصر قائمة كبند عمل إلا عندما يتضمن النشاط شريط التطبيقات. قيم صالحة:

القيمة	الوصف
`ifRoom`	يُرجى وضع هذا العنصر فقط في شريط التطبيقات إذا كان هناك مجال لذلك. إذا لم يكن هناك مجال لجميع العناصر المميزة بـ `"ifRoom"`، العناصر ذات أدنى قيمة يتم عرض قيم `orderInCategory` كإجراءات، يتم عرض العناصر المتبقية في القائمة الكاملة.
`withText`	قم أيضًا بتضمين نص العنوان (محدد `android:title`) مع بند العمل. يمكنك تضمين هذه القيمة مع قيمة الأخرى كعلامة تم وضعها من خلال فصلها بشريط `\|`.
`never`	عدم وضع هذا العنصر في شريط التطبيقات مطلقًا. بدلاً من ذلك، قم بإدراج العنصر في القائمة الكاملة لشريط التطبيقات القائمة.
`always`	ضع هذا العنصر دائمًا في شريط التطبيقات. تجنَّب استخدام هذه السمة إلا إذا كان من الضروري أن يظهر العنصر دائمًا في الإجراء الشريط. قد يؤدي ضبط عناصر متعددة لتظهر دائمًا كبنود عمل إلى تداخلها مع واجهة مستخدم أخرى في شريط التطبيق.
`collapseActionView`	عرض الإجراء المرتبط مع بند العمل هذا (كما هو موضح من قِبل `android:actionLayout` أو `android:actionViewClass`) هو قابلة للطي. تم طرح هذه الميزة في المستوى 14 من واجهة برمجة التطبيقات

الاطّلاع على مقالة إضافة شريط التطبيقات لمزيد من المعلومات.

وتم تقديم هذه المقاييس في المستوى 11 من واجهة برمجة التطبيقات.

android:actionLayout

مورد التنسيق: تنسيق يُستخدم كطريقة عرض الإجراء.

لمزيد من المعلومات، يمكنك الاطّلاع على استخدام الإجراء. جهات المشاهدة والإجراءات

وتم تقديم هذه المقاييس في المستوى 11 من واجهة برمجة التطبيقات.

android:actionViewClass

اسم الصف. اسم فئة مؤهَّل بالكامل لـ View استخدامه كعرض الإجراء. على سبيل المثال: "android.widget.SearchView" استخدام SearchView كعرض إجراء.

لمزيد من المعلومات، يمكنك الاطّلاع على استخدام الإجراء. جهات المشاهدة والإجراءات

تحذير: في حال إخفاء مفاتيح فك تشفير الرمز باستخدام ProGuard أو أداة مشابهة، تأكد من استبعاد الفئة التي تحددها في هذه السمة من إعادة التسمية، لأنها قد تؤدي إلى تعطيل الأخرى.

وتم تقديم هذه المقاييس في المستوى 11 من واجهة برمجة التطبيقات.

android:actionProviderClass

اسم الصف. اسم فئة مؤهل بالكامل لـ ActionProvider لاستخدامه بدلاً من بند العمل. على سبيل المثال: عليك "android.widget.ShareActionProvider" استخدام ShareActionProvider.

لمزيد من المعلومات، يمكنك الاطّلاع على استخدام الإجراء. جهات المشاهدة والإجراءات

وتم طرح هذه الميزة في المستوى 14 من واجهة برمجة التطبيقات.

android:alphabeticShortcut

السعر حرف لمفتاح الاختصار الأبجدي.

android:numericShortcut

عدد صحيح. رقم لمفتاح الاختصار الرقمي.

android:alphabeticModifiers

الكلمة الرئيسية. أداة تعديل للترتيب الأبجدي لعنصر القائمة الاختصار. تتوافق القيمة التلقائية مع عنصر Control. المفتاح. قيم صالحة:

القيمة	الوصف
`META`	يتطابق مع المفتاح الوصفي `Meta`.
`مفتاح CTRL`	يتوافق مع المفتاح الوصفي `Control`.
`نص بديل`	يتوافق مع المفتاح الوصفي `Alt`.
`التغيير`	يتوافق مع مفتاح التعريف `Shift`.
`الرمز`	يتطابق مع المفتاح الوصفي `Sym`.
`الوظيفة`	يتطابق مع المفتاح التعريفي `Function`.

ملاحظة: يمكنك تحديد كلمات رئيسية متعددة في . على سبيل المثال: تشير السمة android:alphabeticModifiers="CTRL|SHIFT" إلى بحيث لتشغيل عنصر القائمة المقابل، يحتاج المستخدم إلى اضغط على كل من مفتاحي Control وShift معًا باستخدام الاختصار.

يمكنك استخدام طريقة setAlphabeticShortcut() لإجراء ما يلي: وتعيين قيم السمات آليًا. لمزيد من المعلومات حول سمة alphabeticModifier، يمكنك الاطّلاع على alphabeticModifiers

android:numericModifiers

الكلمة الرئيسية. معدِّل للاختصار الرقمي لعنصر القائمة. وتتطابق القيمة التلقائية مع مفتاح Control. صالحة القيم التالية:

القيمة	الوصف
`META`	يتطابق مع المفتاح الوصفي `Meta`.
`مفتاح CTRL`	يتوافق مع المفتاح الوصفي `Control`.
`نص بديل`	يتوافق مع المفتاح الوصفي `Alt`.
`التغيير`	يتوافق مع مفتاح التعريف `Shift`.
`الرمز`	يتطابق مع المفتاح الوصفي `Sym`.
`الوظيفة`	يتطابق مع المفتاح التعريفي `Function`.

ملاحظة: يمكنك تحديد كلمات رئيسية متعددة في . على سبيل المثال: تشير السمة android:numericModifiers="CTRL|SHIFT" إلى بحيث لتشغيل عنصر القائمة المقابل، يحتاج المستخدم إلى اضغط على كل من مفتاحي Control وShift معًا باستخدام الاختصار.

يمكنك استخدام طريقة setNumericShortcut() لضبط قيم السمات آليًا. لمزيد من المعلومات عن السمة numericModifier، يمكنك الاطّلاع على numericModifiers

android:checkable

منطقي. True إذا كان العنصر قابلاً للتحديد.

android:checked

منطقي. True إذا كان العنصر محددًا بشكل افتراضي.

android:visible

منطقي. True إذا كان العنصر مرئيًا بشكل افتراضي.

android:enabled

منطقي. True إذا كان العنصر مُفعَّلاً بشكلٍ تلقائي.

android:menuCategory

الكلمة الرئيسية. القيمة المقابلة لـ CATEGORY_* في Menu الثوابت التي تحدد أولوية العنصر. قيم صالحة:

القيمة	الوصف
`container`	بالنسبة إلى العناصر التي تشكل جزءًا من .
`system`	بالنسبة للعناصر التي توفرها .
`secondary`	بالنسبة إلى العناصر التي يقدّمها المستخدم كعناصر ثانوية (نادرًا ما يتم استخدامها).
`alternative`	بالنسبة إلى العناصر التي تمثّل إجراءات بديلة على البيانات المعروضة حاليًا.

android:orderInCategory

عدد صحيح. ترتيب أهمية العنصر داخل مجموعة.

<group>

مجموعة قوائم لإنشاء مجموعة من العناصر التي تشترك في سمات، مثلاً ما إذا كانت مرئية أو ممكَّنة أو قابلة للاختيار. تحتوي على عنصر <item> واحد أو أكثر. يجب أن تكون التابعة لعنصر <menu>.

السمات:

android:id

رقم تعريف المورد. معرّف مورد فريد. لإنشاء معرّف مورد جديد لهذا العنصر، استخدم النموذج: "@+id/name" تشير علامة الجمع إلى أن هذا تم إنشاؤه كـ رقم التعريف

android:checkableBehavior

الكلمة الرئيسية. نوع السلوك القابل للاختيار للمجموعة. قيم صالحة:

القيمة	الوصف
`none`	غير قابل للاختيار.
`all`	يمكن تحديد كل العناصر (استخدم مربّعات الاختيار).
`single`	يمكن تحديد عنصر واحد فقط (استخدم الراديو الأزرار).

android:visible

منطقي. True إذا كانت المجموعة مرئية.

android:enabled

منطقي. صحيح إذا كانت المجموعة مفعّلة.

android:menuCategory

الكلمة الرئيسية. القيمة المقابلة لـ CATEGORY_* في Menu الثوابت التي تحدد أولوية المجموعة. قيم صالحة:

القيمة	الوصف
`container`	بالنسبة إلى المجموعات التي تشكّل جزءًا من .
`system`	بالنسبة إلى المجموعات المقدَّمة من: .
`secondary`	بالنسبة إلى المجموعات التي يوفّرها المستخدم بشكل ثانوي (نادرًا ما يتم استخدامها).
`alternative`	للمجموعات التي تمثّل إجراءات بديلة على البيانات المعروضة حاليًا.

android:orderInCategory

عدد صحيح. تمثّل هذه السمة الترتيب التلقائي للعناصر ضمن الفئة.

مثلا:

تم حفظ ملف XML في res/menu/example_menu.xml:

<menu xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto">
    <item android:id="@+id/item1"
          android:title="@string/item1"
          android:icon="@drawable/group_item1_icon"
          app:showAsAction="ifRoom|withText"/>
    <group android:id="@+id/group">
        <item android:id="@+id/group_item1"
              android:onClick="onGroupItemClick"
              android:title="@string/group_item1"
              android:icon="@drawable/group_item1_icon" />
        <item android:id="@+id/group_item2"
              android:onClick="onGroupItemClick"
              android:title="@string/group_item2"
              android:icon="@drawable/group_item2_icon" />
    </group>
    <item android:id="@+id/submenu"
          android:title="@string/submenu_title"
          app:showAsAction="ifRoom|withText" >
        <menu>
            <item android:id="@+id/submenu_item1"
                  android:title="@string/submenu_item1" />
        </menu>
    </item>
</menu>

يعمل رمز التطبيق التالي على تضخيم القائمة من خلال معاودة الاتصال onCreateOptionsMenu(Menu) وتوضيح الزر عند النقر معاودة الاتصال لاثنين من العناصر:

Kotlin

override fun onCreateOptionsMenu(menu: Menu): Boolean {
    menuInflater.inflate(R.menu.example_menu, menu)
    return true
}

fun onGroupItemClick(item: MenuItem) {
    // One of the group items (using the onClick attribute) was clicked.
    // The item parameter passed here indicates which item it is.
    // All other menu item clicks are handled by Activity.onOptionsItemSelected.
}

Java

public boolean onCreateOptionsMenu(Menu menu) {
    MenuInflater inflater = getMenuInflater();
    inflater.inflate(R.menu.example_menu, menu);
    return true;
}

public void onGroupItemClick(MenuItem item) {
    // One of the group items (using the onClick attribute) was clicked.
    // The item parameter passed here indicates which item it is.
    // All other menu item clicks are handled by Activity.onOptionsItemSelected.
}

التنسيق

سلسلة