Valikkoresurssi

Valikkoresurssi määrittelee sovelluksen valikon (Valinnat-valikko, Kontekstivalikko tai alivalikko), joka voidaan täyttää MenuInflater.

Valikoiden käytön opastus on valikoiden kehittäjän oppaassa.

Tiedoston sijainti:res/menu/filename.xml
Tiedoston nimeä käytetään resurssin tunnuksena. compiled resource datatype: Resurssin osoitinMenu(tai aliluokan) resurssiin. resource reference: Javassa:R.menu.filename
XML:ssä:@menu.filenamesyntaksi: elements:<menu>Pakollinen. Tämän on oltava juurisolmu. Sisältää<item>ja/tai<group>elementtejä.

attributes:

xmlns:androidXML-nimiavaruus. Pakollinen. Määrittää XML-nimiavaruuden, jonka on oltava"http://schemas.android.com/apk/res/android".<item>Valikkoelementti. Voi sisältää<menu>-elementin (alivalikkoa varten). Täytyy olla<menu>– tai<group>-elementin lapsi.

attributes:

android:idResurssin ID. Yksilöllinen resurssin ID. Jos haluat luoda tälle elementille uuden resurssitunnuksen, käytä muotoa:"@+id/name". Plus-symboli osoittaa, että tämä olisi luotava uutenaID:nä.android:titleMerkkijono resource. Valikon otsikko merkkijonoresurssina tai raakana merkkijonona.android:titleCondensedString resource. Tiivistetty otsikko merkkijonoresurssina tai raa’ana merkkijonona. Tätä otsikkoa käytetään tilanteissa, joissa normaali otsikko on liian pitkä.android:iconPiirrettävä resurssi. Kuva, jota käytetään valikkokohteen kuvakkeena.android:onClickMenetelmän nimi. Metodi, jota kutsutaan, kun tätä valikkokohtaa napsautetaan. Metodi on ilmoitettava aktiviteetissa julkisena ja sen ainoana parametrina on oltavaMenuItem, joka ilmaisee klikatun kohteen. Tämä metodi on etusijallaonOptionsItemSelected():n standardipalautukseen nähden. Katso alareunassa oleva esimerkki.

Varoitus: Jos peität koodisi käyttämällä ProGuardia (tai vastaavaa työkalua),muista sulkea tässä attribuutissa määrittelemäsi metodi uudelleennimeämisen ulkopuolelle, koska se voi rikkoa toiminnallisuuden.

Tuotu API-tasolla 11.

android:showAsActionAvainsana. Milloin ja miten tämän kohteen tulisi näkyä toimintokohteena sovelluspalkissa. Valikkokohde voi näkyä toimintokohteena vain silloin, kun toiminto sisältää sovelluspalkin. Kelvolliset arvot:

arvo	kuvaus
ifRoom	Tämä kohde sijoitetaan sovelluspalkkiin vain, jos sille on tilaa. Jos kaikille "ifRoom"-merkityille kohteille ei ole tilaa, pienimmän orderInCategory-arvon omaavat kohteet näytetään toimintoina, ja loput kohteet näytetään ylivuotovalikossa.
withText	Lisää toimintokohteeseen myös otsikkoteksti (määritelty android:title:ssä). Voit sisällyttää tämän arvon yhdessä jonkun muun kanssa lippusarjana erottamalla ne toisistaan putkella |.
never	Ei tätä kohdetta saa koskaan sijoittaa sovelluspalkkiin. Luettele sen sijaan kohde sovelluspalkin ylimenovalikossa.
always	Sijoita tämä kohde aina sovelluspalkkiin.Vältä käyttämästä tätä, ellei ole kriittistä, että kohde näkyy aina toimintopalkissa. Useiden kohteiden asettaminen näkymään aina toimintokohteina voi johtaa siihen, että ne menevät päällekkäin muiden käyttöliittymien kanssa sovelluspalkissa.
collapseActionView	Tämän toimintokohteeseen liittyvä toimintonäkymä (sellaisena kuin se on ilmoitettu android:actionLayout– tai android:actionViewClass-kohdassa) on kokoontaitettava. Tuotu API-tasolla 14.

Katso lisätietoja Sovelluspalkin lisääminen -koulutusluokasta.

Tuotu API-tasolla 11.

android:actionLayoutAsetteluresurssi. Asettelu, jota käytetään toimintonäkymänä.

Katso lisätietoja kohdassa Toimintanäkymät ja toimintojen tarjoajat.

Tuotu API-tasolla 11.

android:actionViewClassLuokan nimi. Toimintanäkymänä käytettävänViewtäysin määritellyn luokan nimi. Esimerkiksi"android.widget.SearchView"käyttääksesiSearchViewtoimintonäkymänä.

Katso lisätietoja kohdasta Toimintanäkymät ja toimintojen tarjoajat.

Varoitus: Jos peität koodisi käyttämällä ProGuardia (tai vastaavaa työkalua),muista sulkea tässä attribuutissa määrittelemäsi luokka uudelleennimeämisen ulkopuolelle, koska se voi rikkoa toiminnallisuuden.

Tuotu API-tasolla 11.

android:actionProviderClassLuokan nimi. Täysin määritetty luokan nimi, jotaActionProviderkäytetään toimintoelementin sijasta. Esimerkiksi"android.widget.ShareActionProvider"käyttääksesiShareActionProvider.

Katso lisätietoja kohdasta Toimintanäkymät ja toimintojen tarjoajat.

Varoitus: Jos peität koodisi käyttämällä ProGuardia (tai vastaavaa työkalua),muista sulkea tässä attribuutissa määrittelemäsi luokka uudelleennimeämisen ulkopuolelle, koska se voi rikkoa toiminnallisuuden.

Tuotu API-tasolla 14.

android:alphabeticShortcutChar. Aakkosellinen pikanäppäimen merkki.android:numericShortcutInteger. Numeerisen pikanäppäimen numero.android:alphabeticModifiersAvainsana. Valikkokohdan aakkosellisen pikanäppäimen muokkausmerkki. Oletusarvo vastaa Control-näppäintä. Kelvolliset arvot:

.

arvo	kuvaus
META	Vastaa Meta-metanäppäintä
CTRL	Vastaa metanäppäintä Control
ALT	Vastaa näppäintä Alt. metanäppäin
SHIFT	Vastaa Shift metanäppäintä
SYM	Vastaa Sym-metanäppäintä
FUNCTION	Vastaa Function-metanäppäintä

Huom: Voit määrittää attribuutissa useita avainsanoja. Esimerkiksi android:alphabeticModifiers="CTRL|SHIFT" ilmaisee, että vastaavan valikkokohdan käynnistämiseksi käyttäjän on painettava sekä Control- että Shift-metanäppäimiä yhdessä pikanäppäimen kanssa.

Ominaisuuksien arvot voi asettaa ohjelmallisesti setAlphabeticShortcut()-menetelmällä. Lisätietoja alphabeticModifier-attribuutista on kohdassa alphabeticModifiers.

android:numericModifiersAvainsana. Valikkokohdan numeerisen pikavalinnan muokkaaja. Oletusarvo vastaa Control-näppäintä. Kelvolliset arvot:

.

Value	Kuvaus
META	Vastaa Meta-meta-avainta
CTRL	Vastaa Control-metanäppäintä
ALT	Vastaa Alt-metanäppäintä. näppäin
SHIFT	Vastaa Shift-metanäppäintä
SYM	Vastaa Sym-metanäppäintä
FUNCTION	Vastaa Function-metanäppäintä

Huom: Voit määrittää attribuutissa useita avainsanoja. Esimerkiksi android:numericModifiers="CTRL|SHIFT" ilmaisee, että vastaavan valikkokohdan käynnistämiseksi käyttäjän on painettava sekä Control- että Shift-metanäppäimiä yhdessä pikanäppäimen kanssa.

Ominaisuuksien arvot voi asettaa ohjelmallisesti setNumericShortcut()-menetelmällä. Lisätietoja numericModifier -attribuutista on osoitteessa numericModifiers.

android:checkableBoolean. ”true”, jos kohde on tarkistettavissa.android:checkedBoolean. ”true”, jos kohde on oletusarvoisesti tarkistettavissa.android:visibleBoolean. ”true”, jos kohde on oletusarvoisesti näkyvissä.android:enabledBoolean. ”true”, jos kohde on oletusarvoisesti käytössä.android:menuCategoryAvainsana. Arvo, joka vastaaMenuCATEGORY_*-vakioita, jotka määrittävät kohteen prioriteetin. Kelvollisia arvoja:

Value	Kuvaus
container	Kohteille, jotka ovat osa konttoria.
system	Kohteille, jotka ovat järjestelmän tarjoamia.
secondary	Kohteille, jotka ovat käyttäjän antamia toissijaisia (harvoin käytettyjä) vaihtoehtoja.
alternative	Kohteille, jotka ovat vaihtoehtoisia toimintoja parhaillaan näytettäville tiedoille.

android:orderInCategoryKokonaisluku. Kohteen ”tärkeysjärjestys” ryhmän sisällä.<group>Valikkoryhmä (luodaan kokoelma kohteita, joilla on yhteisiä piirteitä, kuten ovatko ne näkyvissä, käytössä tai tarkistettavissa). Sisältää yhden tai useamman<item>-elementin. Sen on oltava<menu>-elementin lapsi.

attributes:

android:idResurssin ID. Yksilöllinen resurssin ID. Jos haluat luoda tälle elementille uuden resurssitunnuksen,käytä lomaketta:"@+id/name". Plus-symboli osoittaa, että tämä on luotava uutenaID:nä.android:checkableBehaviorAvainsana. Ryhmän tarkistettavan käyttäytymisen tyyppi. Kelvolliset arvot:

Arvo	Kuvaus
none	Ei tarkistettavissa
all	Kaikki kohteet. voidaan tarkistaa (käytä valintaruutuja)
single	Vain yhden kohteen voi tarkistaa (käytä radiopainikkeita)

android:visibleBoolean. ”true”, jos ryhmä on näkyvissä.android:enabledBoolean. ”true”, jos ryhmä on käytössä.android:menuCategoryAvainsana. Arvo, joka vastaaMenuCATEGORY_*vakioita, jotka määrittävät ryhmän prioriteetin. Kelvollisia arvoja:

Value	Kuvaus
container	Ryhmille, jotka ovat osa containeria.
system	Ryhmille, jotka ovat järjestelmän tarjoamia.
secondary	Ryhmille, jotka ovat käyttäjän antamia toissijaisia (harvoin käytettyjä) vaihtoehtoja.
alternative	Ryhmille, jotka ovat vaihtoehtoisia toimintoja parhaillaan näytettäville tiedoille.

android:orderInCategoryKokonaisluku. Luokan sisältämien kohteiden oletusjärjestys. esim: XML-tiedosto tallennettu osoitteeseenres/menu/example_menu.xml:

Seuraava sovelluskoodi paisuttaa valikon onCreateOptionsMenu(Menu) -kutsusta ja ilmoittaa myös kahden kohteen on-clickcallbackin:

.