En menuressource definerer en programmenu (Indstillingsmenu, kontekstmenu eller undermenu), der kan fyldes op med MenuInflater.
For en vejledning i brugen af menuer, se Menusdeveloper-vejledningen.
filplacering:res/menu/filename.xml
Filnavnet vil blive brugt som ressource-ID. kompileret ressource datatype: Ressource pointer til enMenu(eller underklasse)-ressource. ressourcereference:MenuI Java:R.menu.filename
I XML:R.menu.filename
I XML:@menu.filenamesyntaks: elementer:<menu>Krævet. Dette skal være rodknuden. Indeholder<item>og/eller<group>-elementer.
attributes:
xmlns:androidXML-navneområde. Er påkrævet. Angiver XML-navneområdet, som skal være"http://schemas.android.com/apk/res/android".<item>Et menupunkt. Kan indeholde et<menu>-element (for en undermenu). Skal være et barn af et<menu>– eller<group>-element.
attributter:
android:idRessource-id. Et entydigt ressource-id. Hvis du vil oprette et nyt ressource-id for dette element, skal du bruge formularen:"@+id/name". Plus-symbolet angiver, at dette skal oprettes som et nytID.android:titleString ressource. Menutitlen som en strengressource eller en rå streng.android:titleCondensedString ressource. En kondenseret titel som en strengressource eller en rå streng. Denne titel bruges i situationer, hvor den normale titel er for lang.android:iconTegningsbar ressource. Et billede, der skal bruges som ikon for menupunktet.android:onClickMetodenavn. Den metode, der skal kaldes, når der klikkes på dette menupunkt. Metoden skal være erklæret som offentlig i aktiviteten og acceptere enMenuItemsom den eneste parameter, der angiver det element, der klikkes på. Denne metode har forrang frem for standardcallback tilonOptionsItemSelected(). Se eksemplet i bunden.
Varsel: Hvis du slører din kode ved hjælp af ProGuard (eller et lignende værktøj), skal du sørge for at udelukke den metode, du angiver i denne attribut, fra omdøbning, da det kan ødelægge funktionaliteten.
Indført i API-niveau 11.
android:showAsActionNøgleord. Hvornår og hvordan dette element skal vises som et handlingselement i app-linjen. Et menupunkt kan kun vises som et handlingselement, når aktiviteten omfatter en app-bar. Gyldige værdier:
| Værdi | Beskrivelse |
|---|---|
ifRoom |
Placér kun dette element i app-linjen, hvis der er plads til det. Hvis der ikke er plads til alle de elementer, der er markeret "ifRoom", vises elementerne med de laveste orderInCategory-værdier som handlinger, og de resterende elementer vises i overløbsmenuen. |
withText |
Inkluder også titelteksten (defineret ved android:title) sammen med handlingselementet. Du kan medtage denne værdi sammen med en af de andre værdier som et flagsæt ved at adskille dem med et rør |. |
never |
Placér aldrig dette element i app-linjen. Angiv i stedet elementet i appbjælkens overløbsmenu. |
always |
placer altid dette element i appbjælken.Undgå at bruge dette, medmindre det er afgørende, at elementet altid vises i handlingsbjælken. Hvis du indstiller flere elementer til altid at blive vist som handlingselementer, kan det resultere i, at de overlapper med andre brugergrænseflader i app-linjen. |
collapseActionView |
Den handlingsvisning, der er tilknyttet dette handlingselement (som angivet med android:actionLayout ellerandroid:actionViewClass), er sammenklappelig.Indført i API-niveau 14. |
Se kursusklassen Tilføjelse af app-linjen for at få flere oplysninger.
Indført i API-niveau 11.
android:actionLayoutLayoutressource. Et layout, der skal bruges som handlingsvisning.
Se Action Views og Action Providers for at få flere oplysninger.
Indført i API-niveau 11.
android:actionViewClassKlassens navn. Et fuldt kvalificeret klassenavn for denViewsom skal bruges som handlingsvisning. F.eks."android.widget.SearchView"for at brugeSearchViewsom handlingsvisning.
Se Handlingsvisninger og handlingsudbydere for at få flere oplysninger.
Varsling: Hvis du slører din kode ved hjælp af ProGuard (eller et lignende værktøj), skal du sørge for at udelukke den klasse, du angiver i denne attribut, fra omdøbning, da det kan ødelægge funktionaliteten.
Indført i API-niveau 11.
android:actionProviderClassKlassens navn. Et fuldt kvalificeret klassenavn for denActionProvider, der skal bruges i stedet for handlingselementet. F.eks."android.widget.ShareActionProvider"for at brugeShareActionProvider.
Se Handlingsvisninger og handlingsudbydere for at få flere oplysninger.
Varsling: Hvis du slører din kode ved hjælp af ProGuard (eller et lignende værktøj), skal du sørge for at udelukke den klasse, du angiver i denne attribut, fra omdøbning, da det kan ødelægge funktionaliteten.
Indført i API-niveau 14.
android:alphabeticShortcutChar. Et tegn for den alfabetiske genvejstast.android:numericShortcutInteger. Et tal for den numeriske genvejstast.android:alphabeticModifiersNøgleord. Et modifikator for menupunktets alfabetiske genvejstast. Standardværdien svarer til kontroltasten. Gyldige værdier:
| Værdi | Beskrivelse |
|---|---|
META |
Korresponderer til metatasten Meta |
| CTRL | Korresponderer til metatasten Control |
| ALT | Korresponderer til Alt metatasten |
| SHIFT | Korresponderer til Shift-metatasten |
| SYM | Korresponderer til svarer til metatasten Sym |
| FUNCTION | Korresponderer til metatasten Function |
Note: Du kan angive flere nøgleord i en attribut. F.eks. angiver android:alphabeticModifiers="CTRL|SHIFT", at brugeren skal trykke på både Control- og Shift-metatasterne sammen med genvejen for at udløse det tilsvarende menupunkt.
Du kan bruge setAlphabeticShortcut()-metoden til at angive attributværdierne programmatisk. Du kan finde flere oplysninger om alphabeticModifier-attributten på alphabeticModifiers.
android:numericModifiersNøgleord. En modificator for menupunktets numeriske genvej. Standardværdien svarer til kontroltasten. Gyldige værdier:
| Værdi | Beskrivelse | |
|---|---|---|
| META | Korresponderer til metatasten Meta | |
| CTRL | Korresponderer til metatasten Control | |
| ALT | Korresponderer til metatasten Alt tast | |
| SHIFT | Korresponderer til Shift-metatasten | |
| SYM | Korresponderer til svarer til metatasten Sym | |
| FUNCTION | Korresponderer til metatasten Function |
Note: Du kan angive flere nøgleord i en attribut. F.eks. angiver android:numericModifiers="CTRL|SHIFT", at brugeren skal trykke på både Control- og Shift-metatasterne sammen med genvejstasten for at udløse det tilsvarende menupunkt.
Du kan bruge setNumericShortcut()-metoden til at angive attributværdierne programmatisk. Du kan finde flere oplysninger om attributten numericModifier på numericModifiers.
Boolean. “true”, hvis elementet kan kontrolleres.android:checkedBoolean. “true”, hvis elementet er kontrolleret som standard.android:visibleBoolean. “true”, hvis elementet er synligt som standard.android:enabledBoolean. “true”, hvis elementet er aktiveret som standard.android:menuCategoryNøgleord. Værdi svarende tilMenuCATEGORY_*konstanter, som definerer elementets prioritet. Gyldige værdier:
| Værdi | Beskrivelse |
|---|---|
container |
For elementer, der er en del af encontainer. |
system |
For elementer, der leveres af systemet. |
secondary |
For elementer, der er sekundære (sjældent anvendte) indstillinger, som leveres af brugeren. |
alternative |
For elementer, der er alternative handlinger på de data, der vises i øjeblikket. |
android:orderInCategoryHeltal. Rækkefølgen af elementets “vigtighed” inden for en gruppe.<group>En menugruppe (for at oprette en samling af elementer, der deler egenskaber, f.eks. om de er synlige, aktiverede eller kan kontrolleres). Indeholder et eller flere<item>-elementer. Skal være et barn af et<menu>-element.
attributter:
android:idRessource-id. Et entydigt ressource-id. Hvis du vil oprette et nyt ressource-id for dette element, skal du bruge formularen:"@+id/name". Plus-symbolet angiver, at dette skal oprettes som et nytID.android:checkableBehaviorNøgleord. Den type kontrollerbar adfærd for gruppen. Gyldige værdier:
| Værdi | Beskrivelse |
|---|---|
none |
Kan ikke kontrolleres |
all |
Alle elementer kan afkrydses (brug afkrydsningsfelter) |
single |
Kun ét punkt kan afkrydses (brug radioknapper) |
android:visibleBoolean. “true”, hvis gruppen er synlig.android:enabledBoolean. “true”, hvis gruppen er aktiveret.android:menuCategoryNøgleord. Værdi svarende tilMenuCATEGORY_*konstanter, som definerer gruppens prioritet. Gyldige værdier:
| Værdi | Beskrivelse |
|---|---|
container |
For grupper, der er en del af encontainer. |
system |
For grupper, der leveres af systemet. |
secondary |
For grupper, der er sekundære (sjældent anvendte) indstillinger, som leveres af brugeren. |
alternative |
For grupper, der er alternative handlinger på de data, der vises i øjeblikket. |
android:orderInCategoryHeltal. Standardrækkefølgen for elementerne i kategorien. eksempel: XML-fil gemt påres/menu/example_menu.xml:
Den følgende programkode puster menuen op fra onCreateOptionsMenu(Menu)-callbacken og deklarerer også on-click-callbacken for to af elementerne: