Menü erőforrás

A menü erőforrás egy alkalmazás menüjét (Beállítások menü, Kontextusmenü vagy almenü) határozza meg, amelyet a MenuInflater.

A menük használatáról szóló útmutatót lásd a Menük fejlesztői útmutatóban.

fájl helye:res/menu/filename.xml
A fájlnevet fogja használni az erőforrás azonosítójaként. compiled resource datatype: Erőforrás mutató egyMenu(vagy alosztály) erőforrásra. erőforrás hivatkozás: Java nyelven:R.menu.filename
Az XML-ben:@menu.filenameszintaxis: elements:<menu>Kötelező. Ennek a gyökércsomópontnak kell lennie.<item>és/vagy<group>elemeket tartalmaz.

attributes:

xmlns:androidXML névtér. Kötelező. Meghatározza az XML névteret, amelynek"http://schemas.android.com/apk/res/android"-nek kell lennie.<item>Egy menüelem. Tartalmazhat egy<menu>elemet (almenü esetén). Egy<menu>vagy<group>elem gyermekének kell lennie.

attributes:

android:idErőforrás azonosító. Egyedi erőforrás azonosító. Ha új erőforrás-azonosítót szeretne létrehozni ehhez az elemhez, használja a:"@+id/name"formát. A plusz szimbólum azt jelzi, hogy ezt newID-ként kell létrehozni.android:titleString erőforrás. A menü címe string erőforrásként vagy nyers stringként.android:titleCondensedString erőforrás. A tömörített cím string erőforrásként vagy nyers stringként. Ez a cím olyan helyzetekben használható, amikor a normál cím túl hosszú.android:iconRajzolható erőforrás. A menüpont ikonjaként használandó kép.android:onClickMódszer neve. A menüpontra való kattintáskor meghívandó metódus. A metódust az aktivitásban publicként kell deklarálni, és egyMenuItem-t kell elfogadnia egyedüli paraméterként, amely a kattintott elemet jelzi. Ez a módszer elsőbbséget élvez aonOptionsItemSelected()szabványos visszahívásával szemben. Lásd a példát alul.

Figyelmeztetés: Ha a kódot a ProGuard (vagy egy hasonló eszköz) segítségével homályosítja, ügyeljen arra, hogy az ebben az attribútumban megadott metódust kizárja az átnevezésből, mert ez megszakíthatja a funkcionalitást.

A 11. API-szintben vezették be.

android:showAsActionKulcsszó. Mikor és hogyan jelenjen meg ez az elem műveleti elemként az alkalmazássávban. Egy menüelem csak akkor jelenhet meg műveleti elemként, ha a tevékenység tartalmaz egy alkalmazássávot. Érvényes értékek:

érték	leírás
ifRoom	Ezt az elemet csak akkor helyezze el az alkalmazássávban, ha van rá hely. Ha nincs hely az összes "ifRoom" jelű elem számára, akkor a legalacsonyabb orderInCategory értékkel rendelkező elemek jelennek meg akcióelemként, a többi elem pedig a túlcsordulási menüben.
withText	Az akcióelemhez csatolja a (android:title által meghatározott) címszöveget is. Ezt az értéket a többi érték valamelyikével együtt flag setként is felveheti, ha csővel választja el őket |.
never	Nem helyezheti ezt az elemet az alkalmazássávba. Ehelyett sorolja fel az elemet az alkalmazássáv túlfolyómenüjében.
always	Ezt az elemet mindig az alkalmazássávban helyezze el.Kerülje ennek használatát, hacsak nem kritikus, hogy az elem mindig az akciósávban jelenjen meg. Több elem beállítása, hogy mindig akcióelemként jelenjen meg, azt eredményezheti, hogy átfedésbe kerülhet más felhasználói felülettel az alkalmazássávban.
collapseActionView	Az ehhez az akcióelemhez tartozó (a android:actionLayout vagy android:actionViewClass által deklarált) akciónézet összecsukható. Az API 14. szintjén vezették be.

Bővebb információért lásd az Alkalmazássáv hozzáadása oktatóórát.

Az API 11. szintjén vezették be.

android:actionLayoutElrendezési erőforrás. A műveleti nézetként használandó elrendezés.

Bővebb információért lásd: Műveleti nézetek és műveleti szolgáltatók.

Elkészült az API 11. szintjén.

android:actionViewClassOsztály neve. AViewakciónézetként használandóViewteljesen minősített osztálynév. Például"android.widget.SearchView"aSearchViewakciónézetként való használatához.

Bővebb információért lásd: Action Views és Action Providers.

Figyelmeztetés: Ha a kódot a ProGuard (vagy egy hasonló eszköz) segítségével homályosítja, ügyeljen arra, hogy az ebben az attribútumban megadott osztályt kizárja az átnevezésből, mert ez megszakíthatja a funkcionalitást.

A 11. API-szintben bevezetett.

android:actionProviderClassOsztály neve. A műveleti elem helyett használandóActionProviderteljesen minősített osztálynév. Például"android.widget.ShareActionProvider"aShareActionProviderhasználatához.

Bővebb információért lásd: Action Views és Action Providers.

Figyelmeztetés: Ha a kódot a ProGuard (vagy egy hasonló eszköz) segítségével homályosítja, ügyeljen arra, hogy az ebben az attribútumban megadott osztályt kizárja az átnevezésből, mert ez megszakíthatja a funkcionalitást.

A 14. API-szintben került bevezetésre.

android:alphabeticShortcutChar. Az alfabetikus gyorsbillentyű karaktere.android:numericShortcutEgész szám. Egy szám a numerikus gyorsbillentyűhöz.android:alphabeticModifiersKulcsszó. A menüpont alfabetikus gyorsbillentyűjének módosítója. Az alapértelmezett érték a Control billentyűnek felel meg. Érvényes értékek:

.

érték	leírás
META	megfelel a Meta meta billentyűnek
CTRL	A Control meta-billentyűnek felel
ALT	Az Alt meta billentyű
SHIFT	A Shift meta billentyűnek felel meg
SYM	A Shift meta billentyűnek felel meg. a Sym meta billentyűnek
FUNCTION	A Function meta billentyűnek

Megjegyzés: Egy attribútumban több kulcsszó is megadható. Például a android:alphabeticModifiers="CTRL|SHIFT" azt jelzi, hogy a megfelelő menüelem kiváltásához a felhasználónak a Control és a Shift metabillentyűket is le kell nyomnia a gyorsbillentyűvel együtt.

Az attribútumértékek programozott beállításához használhatja a setAlphabeticShortcut() módszert. A alphabeticModifier attribútummal kapcsolatos további információkat a alphabeticModifiers oldalon talál.

android:numericModifiersKulcsszó. A menüpont numerikus gyorsbillentyűjének módosítója. Az alapértelmezett érték a Control billentyűnek felel meg. Érvényes értékek:

.

érték	leírás
META	Megfelel a Meta meta kulcsnak
CTRL	A Control meta billentyűnek felel
ALT	Az Alt meta billentyűnek felel. billentyű
SHIFT	A Shift meta billentyűnek felel
SYM	A Shift meta billentyűnek felel
Correspondes a Sym meta billentyűnek
FUNCTION	A Function meta billentyűnek

Megjegyzés: Egy attribútumban több kulcsszó is megadható. Például a android:numericModifiers="CTRL|SHIFT" azt jelzi, hogy a megfelelő menüelem kiváltásához a felhasználónak a gyorsbillentyűvel együtt a Control és a Shift metabillentyűt is le kell nyomnia.

Az attribútumértékek programozott beállításához használhatja a setNumericShortcut() módszert. A numericModifier attribútummal kapcsolatos további információkat a numericModifiers oldalon talál.

android:checkableBoolean. “true”, ha az elem ellenőrizhető.android:checkedBoolean. “true”, ha az elem alapértelmezés szerint ellenőrizhető.android:visibleBoolean. “true”, ha az elem alapértelmezés szerint látható.android:enabledBoolean. “true”, ha az elem alapértelmezés szerint engedélyezve van.android:menuCategoryKulcsszó. Az elem prioritását meghatározóMenuCATEGORY_*konstansoknak megfelelő érték. Érvényes értékek:

Value	Description
container	Acontainer részét képező elemek esetében.
system	A rendszer által biztosított elemek esetében.
secondary	A felhasználó által megadott másodlagos (ritkán használt) opciók.
alternative	Az aktuálisan megjelenített adatokra vonatkozó alternatív műveletek.

android:orderInCategoryEgész szám. Az elem “fontossági sorrendje”, egy csoporton belül.<group>Egy menücsoport (olyan elemek gyűjteményének létrehozása, amelyek közös tulajdonságokkal rendelkeznek, például láthatóak, engedélyezettek vagy ellenőrizhetők). Egy vagy több<item>elemet tartalmaz. Egy<menu>elem gyermekének kell lennie.

attributes:

android:idResource ID. Egyedi erőforrás azonosító. Ha új erőforrás-azonosítót szeretne létrehozni ehhez az elemhez,használja a:"@+id/name"formát. A plusz szimbólum jelzi, hogy ezt újID-ként kell létrehozni.android:checkableBehaviorKulcsszó. A csoport ellenőrizhető viselkedésének típusa. Érvényes értékek:

érték	leírás
none	nem ellenőrizhető
all	minden elem. ellenőrizhető (jelölőnégyzetek használata)
single	Csak egy elem ellenőrizhető (rádiógombok használata)

android:visibleBoolean. “true”, ha a csoport látható.android:enabledBoolean. “true”, ha a csoport engedélyezve van.android:menuCategoryKulcsszó. A csoport prioritását meghatározóMenuCATEGORY_*konstansoknak megfelelő érték. Érvényes értékek:

Value	Description
container	Acontainer részét képező csoportok esetében.
system	A rendszer által biztosított csoportok esetében.
secondary	A felhasználók által biztosított másodlagos (ritkán használt) opciókat jelentő csoportok.
alternative	A jelenleg megjelenített adatokra vonatkozó alternatív műveleteket jelentő csoportok.

android:orderInCategoryEgész szám. A kategórián belüli elemek alapértelmezett sorrendje. példa: Ares/menu/example_menu.xmlcímre mentett XML-fájl:

A következő alkalmazáskód felfújja a menüt a onCreateOptionsMenu(Menu) visszahívásból, és a kattintás utáni visszahívást is deklarálja két elemhez:

.