Resursă de meniu

O resursă de meniu definește un meniu de aplicație (meniu de opțiuni, meniu contextual sau submeniu) care poate fi umflat cu MenuInflater.

Pentru un ghid de utilizare a meniurilor, consultați Ghidul dezvoltatorului de meniuri.

locația fișierului:res/menu/filename.xml
Numele fișierului va fi folosit ca ID al resursei. compilated resource datatype: Pointer de resursă către o resursăMenu(sau o subclasă). referință de resursă: În Java:R.menu.filename
În XML:@menu.filenamesintaxa: elemente:<menu>Obligatoriu. Acesta trebuie să fie nodul rădăcină. Conține elemente<item>și/sau<group>.

attributes:

xmlns:androidSpațiu de nume XML. Necesar. Definește spațiul de nume XML, care trebuie să fie"http://schemas.android.com/apk/res/android".<item>Un element de meniu. Poate conține un element<menu>(pentru un submeniu). Trebuie să fie un copil al unui element<menu>sau<group>.

attributes:

android:idID-ul resursei. Un ID unic al resursei. Pentru a crea un nou ID de resursă pentru acest element, utilizați forma:"@+id/name". Simbolul plus indică faptul că acesta ar trebui să fie creat ca un nou ID.android:titleString resource. Titlul meniului ca resursă string sau șir de caractere brut.android:titleCondensedString resource. Un titlu condensat ca resursă string sau șir brut. Acest titlu este utilizat pentru situațiile în care titlul normal este prea lung.android:iconDrawable resource. O imagine care urmează să fie utilizată ca pictogramă a elementului de meniu.android:onClickNumele metodei. Metoda care trebuie apelată atunci când se face clic pe acest element de meniu. Metoda trebuie să fie declarată în activitate ca fiind publică și să accepte unMenuItemca unic parametru, care indică elementul pe care s-a făcut clic. Această metodă are prioritate față de returnarea standard laonOptionsItemSelected(). A se vedea exemplul din partea de jos.

Avertizare: Dacă vă ofuscați codul folosind ProGuard (sau un instrument similar),asigurați-vă că excludeți metoda pe care o specificați în acest atribut de la redenumire, deoarece aceasta poate întrerupe funcționalitatea.

Introdus în API Level 11.

android:showAsActionKeyword. Când și cum ar trebui să apară acest element ca element de acțiune în bara de aplicații. Un element de meniu poate apărea ca element de acțiune numai atunci când activitatea include o bară de aplicații. Valori valide:

Valoare	Descriere
ifRoom	Așezați acest element în bara de aplicații numai dacă există loc pentru el. Dacă nu există loc pentru toate elementele marcate cu "ifRoom", elementele cu cele mai mici valori orderInCategory sunt afișate ca acțiuni, iar elementele rămase sunt afișate în meniul de depășire.
withText	Includeți, de asemenea, textul titlului (definit prin android:title) cu elementul de acțiune. Puteți include această valoare împreună cu una dintre celelalte ca un set de indicatori, separându-le cu o țeavă |.
never	Nu plasați niciodată acest element în bara de aplicații. În schimb, listați elementul în meniul de depășire al barei de aplicații.
always	Puneți întotdeauna acest element în bara de aplicații.Evitați să folosiți acest lucru, cu excepția cazului în care este esențial ca elementul să apară întotdeauna în bara de acțiuni. Setarea mai multor elemente pentru a apărea întotdeauna ca elemente de acțiune poate avea ca rezultat suprapunerea lor cu alte interfețe utilizator în bara de aplicații.
collapseActionView	Vederea de acțiune asociată cu acest element de acțiune (așa cum este declarată de android:actionLayout sauandroid:actionViewClass) este pliabilă. Introdus în API Level 14.

Consultați cursul de formare Adăugarea barei de aplicații pentru mai multe informații.

Introdus în API Level 11.

android:actionLayoutResursă de layout. Un aspect de utilizat ca vizualizare a acțiunii.

Vezi Action Views și Action Providers pentru mai multe informații.

Introdus în API Level 11.

android:actionViewClassNumele clasei. Un nume de clasă complet calificat pentruViewla care se utilizează ca vizualizare de acțiune. De exemplu,"android.widget.SearchView"pentru a utilizaSearchViewca vizualizare de acțiune.

Vezi Action Views și Action Providers pentru mai multe informații.

Avertizare: Dacă vă ofuscați codul folosind ProGuard (sau un instrument similar),asigurați-vă că excludeți clasa pe care o specificați în acest atribut de la redenumire, deoarece aceasta poate întrerupe funcționalitatea.

Introdus în API Level 11.

android:actionProviderClassNumele clasei. Un nume de clasă complet calificat pentru caActionProvidersă fie utilizat în locul elementului de acțiune. De exemplu,"android.widget.ShareActionProvider"pentru a utilizaShareActionProvider.

Vezi Action Views și Action Providers pentru mai multe informații.

Avertizare: Dacă vă ofuscați codul folosind ProGuard (sau un instrument similar),asigurați-vă că excludeți clasa pe care o specificați în acest atribut de la redenumire, deoarece aceasta poate întrerupe funcționalitatea.

Introdus în API Level 14.

android:alphabeticShortcutandroid:alphabeticShortcutChar. Un caracter pentru tasta de prescurtare alfabetică.android:numericShortcutInteger. Un număr pentru tasta de prescurtare numerică.android:alphabeticModifiersKeyword (Cuvânt cheie). Un modificator pentru comanda rapidă alfabetică a elementului de meniu. Valoarea implicită corespunde tastei Control. Valori valide:

.

Valoare	Descriere
META	Corespunde la tasta meta Meta
CTRL	Corespunde la tasta meta Control
ALT	Corespunde la tasta Alt meta tasta
SHIFT	Corespunde la meta tasta Shift
SYM	Correspunde la meta tasta la tasta meta Sym
FUNCTION	Corespunde la tasta meta Function

Nota: Puteți specifica mai multe cuvinte-cheie într-un atribut. De exemplu, android:alphabeticModifiers="CTRL|SHIFT" indică faptul că, pentru a declanșa elementul de meniu corespunzător, utilizatorul trebuie să apese ambele metachei Control și Shift împreună cu comanda rapidă.

Puteți utiliza metoda setAlphabeticShortcut() pentru a seta valorile atributului în mod programatic. Pentru mai multe informații despre atributul alphabeticModifier, mergeți la alphabeticModifiers.

android:numericModifiersCuvânt cheie. Un modificator pentru prescurtarea numerică a elementului de meniu. Valoarea implicită corespunde tastei Control. Valori valide:

.

Valoare	Descriere
META	Corespunde la metacheia Meta
CTRL	Corespunde la metacheia Control
ALT	Corespunde la metacheia Alt
SHIFT	Corespunde la meta tasta Shift
SYM	Correspunde la meta tasta Shift	. la tasta meta Sym
FUNCTION	Corespunde la tasta meta Function

Nota: Puteți specifica mai multe cuvinte-cheie într-un atribut. De exemplu, android:numericModifiers="CTRL|SHIFT" indică faptul că, pentru a declanșa elementul de meniu corespunzător, utilizatorul trebuie să apese ambele metataste Control și Shift împreună cu comanda rapidă.

Puteți utiliza metoda setNumericShortcut() pentru a seta valorile atributului în mod programatic. Pentru mai multe informații despre atributul numericModifier, mergeți la numericModifiers.

android:checkableBoolean. „true” dacă elementul este verificabil.android:checkedBoolean. „true” dacă elementul este verificat în mod implicit.android:visibleBoolean. „true” dacă elementul este vizibil în mod implicit.android:enabledBoolean. „true” dacă elementul este activat în mod implicit.android:menuCategoryCuvânt cheie. Valoare corespunzătoare constantelorMenuCATEGORY_*, care definesc prioritatea elementului. Valori valide:

Valoare	Descriere
container	Pentru elementele care fac parte dintr-un container.
system	Pentru elementele care sunt furnizate de sistem.
secondary	Pentru elementele care sunt opțiuni secundare(rar utilizate) furnizate de utilizator.
alternative	Pentru elementele care sunt acțiuni alternative asupra datelor care sunt afișate în prezent.

android:orderInCategoryNumăr întreg. Ordinea de „importanță” a elementului, în cadrul unui grup.<group>Un grup de meniu (pentru a crea o colecție de elemente care au trăsături comune, cum ar fi dacă sunt vizibile, activate sau verificabile). Conține unul sau mai multe elemente<item>. Trebuie să fie un copil al unui element<menu>.

attributes:

android:idID-ul resursei. Un ID unic al resursei. Pentru a crea un nou ID de resursă pentru acest element,utilizați formularul:"@+id/name". Simbolul plus indică faptul că acesta ar trebui să fie creat ca un nou ID.android:checkableBehaviorCuvânt cheie. Tipul de comportament verificabil pentru grup. Valori valide:

Valoare	Descriere
none	Nu verificabil
all	Toate articolele. pot fi bifate (folosiți casete de selectare)
single	Doar un singur element poate fi bifat (folosiți butoane radio)

android:visibleBoolean. „true” dacă grupul este vizibil.android:enabledBoolean. „true” dacă grupul este activat.android:menuCategoryCuvânt cheie. Valoare corespunzătoare constantelorMenuCATEGORY_*, care definesc prioritatea grupului. Valori valide:

Valoare	Descriere
container	Pentru grupurile care fac parte dintr-un container.
system	Pentru grupurile care sunt furnizate de sistem.
secondary	Pentru grupurile care sunt opțiuni secundare(rar utilizate) furnizate de utilizator.
alternative	Pentru grupurile care sunt acțiuni alternative asupra datelor care sunt afișate în prezent.

android:orderInCategoryNumăr întreg. Ordinea implicită a elementelor din cadrul categoriei. exemplu: Fișier XML salvat lares/menu/example_menu.xml:

Codul aplicației următoare umflă meniul din callback-ul onCreateOptionsMenu(Menu) și declară, de asemenea, callback-ul on-click pentru două dintre elemente:

.