Menü kaynağı

Menü kaynağı, MenuInflater ile genişletilebilen bir uygulama menüsü (seçenekler menüsü, bağlam menüsü veya alt menü) tanımlar.

Menüleri kullanma kılavuzu için Menü ekleme başlıklı makaleyi inceleyin.

dosya konumu:
res/menu/filename.xml
Dosya adı, kaynak kimliği olarak kullanılır
derlenmiş kaynak veri türü:
Bir Menu (veya alt sınıf) kaynağına yönelik kaynak işaretçisi
kaynak referansı:
Java'da: R.menu.filename
XML'de: @[package:]menu.filename
söz dizimi:
<?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>
öğeler:
Zorunlu. Bu, kök düğüm olmalıdır. <item> ve/veya <group> öğeleri içerir.

Özellikler:

xmlns:android
XML ad alanı. Zorunlu. XML ad alanını tanımlar. Bu alan "http://schemas.android.com/apk/res/android" olmalıdır.
<item>
Menü öğesi. Bir <menu> öğesi (alt menü için) içerebilir. <menu> veya <group> öğesinin alt öğesi olmalıdır.

Özellikler:

android:id
Kaynak kimliği. Benzersiz bir kaynak kimliği. Bu öğe için yeni bir kaynak kimliği oluşturmak istiyorsanız şu formu kullanın: "@+id/name". Artı simgesi, bunun yeni bir kimlik olarak oluşturulduğunu gösterir.
android:title
Dize kaynağı. Dize kaynağı veya ham dize olarak menü başlığı.
android:titleCondensed
Dize kaynağı. Dize kaynağı veya ham dize olarak kısaltılmış başlık. Bu başlık, normal başlığın çok uzun olduğu durumlarda kullanılır.
android:icon
Çizilebilir kaynak. Menü öğesi simgesi olarak kullanılacak resim.
android:onClick
Yöntem adı. Bu menü öğesi tıklandığında çağrılacak yöntem. Yöntem, etkinlikte herkese açık olarak tanımlanmalıdır. Tek parametre olarak, tıklanan öğeyi gösteren bir MenuItem kabul eder. Bu yöntem, onOptionsItemSelected() için standart geri çağırma yöntemine göre önceliklidir. Bu sayfanın sonundaki örneğe bakın.

Uyarı: Kodunuzu ProGuard veya benzer bir araç kullanarak karartırsanız bu özellikte belirttiğiniz yöntemi yeniden adlandırma işleminden hariç tuttuğunuzdan emin olun. Aksi takdirde işlevsellik bozulabilir.

API düzeyi 11'de kullanıma sunulmuştur.

android:showAsAction
Anahtar kelime. Bu öğenin uygulama çubuğunda ne zaman ve nasıl işlem öğesi olarak görüneceği. Bir menü öğesi, yalnızca etkinlikte bir uygulama çubuğu varsa işlem öğesi olarak görünebilir. Geçerli değerler:
DeğerAçıklama
ifRoomBu öğeyi yalnızca yer varsa uygulama çubuğuna yerleştirin. "ifRoom" ile işaretlenen tüm öğeler için yer yoksa en düşük orderInCategory değerlerine sahip öğeler işlem olarak, kalan öğeler ise taşma menüsünde gösterilir.
withTextİşlem öğesine başlık metnini de (android:title ile tanımlanır) ekleyin. Bu değeri, diğerlerinden biriyle birlikte dikey çizgiyle | ayırarak işaret grubu olarak ekleyebilirsiniz.
neverBu öğeyi hiçbir zaman uygulama çubuğuna yerleştirmeyin. Bunun yerine, öğeyi uygulama çubuğunun taşma menüsünde listeleyin.
alwaysBu öğeyi her zaman uygulama çubuğuna yerleştirin. Öğenin işlem çubuğunda her zaman görünmesi kritik önem taşımıyorsa bu seçeneği kullanmaktan kaçının. Birden fazla öğeyi her zaman işlem öğesi olarak görünecek şekilde ayarlamak, bu öğelerin uygulama çubuğundaki diğer kullanıcı arayüzü öğeleriyle çakışmasına neden olabilir.
collapseActionViewBu işlem öğesiyle ilişkili işlem görünümü (android:actionLayout veya android:actionViewClass tarafından beyan edildiği şekilde) daraltılabilir.
API düzeyi 14'te kullanıma sunuldu.

Daha fazla bilgi için Uygulama çubuğu ekleme başlıklı makaleyi inceleyin.

API düzeyi 11'de kullanıma sunulmuştur.

android:actionLayout
Düzen kaynağı. İşlem görünümü olarak kullanılacak düzen.

Daha fazla bilgi için İşlem görünümlerini ve işlem sağlayıcıları kullanma başlıklı makaleyi inceleyin.

API düzeyi 11'de kullanıma sunulmuştur.

android:actionViewClass
Sınıf adı. İşlem görünümü olarak kullanılacak View için tam nitelikli bir sınıf adı. Örneğin, "android.widget.SearchView", SearchView öğesini işlem görünümü olarak kullanır.

Daha fazla bilgi için İşlem görünümlerini ve işlem sağlayıcıları kullanma başlıklı makaleyi inceleyin.

Uyarı: Kodunuzu ProGuard veya benzer bir araç kullanarak gizlerseniz bu özellikte belirttiğiniz sınıfı yeniden adlandırma işleminden hariç tutun. Aksi takdirde işlevsellik bozulabilir.

API düzeyi 11'de kullanıma sunulmuştur.

android:actionProviderClass
Sınıf adı. İşlem öğesi yerine kullanılacak ActionProvider için tam sınıf adı. Örneğin, ShareActionProvider kullanmak için "android.widget.ShareActionProvider".

Daha fazla bilgi için İşlem görünümlerini ve işlem sağlayıcıları kullanma başlıklı makaleyi inceleyin.

Uyarı: Kodunuzu ProGuard veya benzer bir araç kullanarak gizlerseniz bu özellikte belirttiğiniz sınıfı yeniden adlandırma işleminden hariç tutun. Aksi takdirde işlevsellik bozulabilir.

API düzeyi 14'te kullanıma sunulmuştur.

android:alphabeticShortcut
Char. Alfabetik kısayol tuşu için bir karakter.
android:numericShortcut
Tam sayı. Sayısal kısayol tuşu için bir sayı.
android:alphabeticModifiers
Anahtar kelime. Menü öğesinin alfabetik kısayolu için değiştirici. Varsayılan değer, Control tuşuna karşılık gelir. Geçerli değerler:
DeğerAçıklama
META Meta meta tuşuna karşılık gelir.
CTRL Control meta tuşuna karşılık gelir.
ALT Alt meta tuşuna karşılık gelir.
ÜST KARAKTER Üst karakter meta tuşuna karşılık gelir.
SYM Sym meta tuşuna karşılık gelir.
FUNCTION İşlev meta tuşuna karşılık gelir.

Not: Bir özellikte birden fazla anahtar kelime belirtebilirsiniz. Örneğin, android:alphabeticModifiers="CTRL|SHIFT", ilgili menü öğesini tetiklemek için kullanıcının kısayolla birlikte hem Control hem de Üst Karakter meta tuşlarına basması gerektiğini gösterir.

Özellik değerlerini programatik olarak ayarlamak için setAlphabeticShortcut() yöntemini kullanabilirsiniz. alphabeticModifier özelliği hakkında daha fazla bilgi için alphabeticModifiers başlıklı makaleyi inceleyin.

android:numericModifiers
Anahtar kelime. Menü öğesinin sayısal kısayolu için bir değiştirici. Varsayılan değer, Control tuşuna karşılık gelir. Geçerli değerler:
DeğerAçıklama
META Meta meta tuşuna karşılık gelir.
CTRL Control meta tuşuna karşılık gelir.
ALT Alt meta tuşuna karşılık gelir.
ÜST KARAKTER Üst karakter meta tuşuna karşılık gelir.
SYM Sym meta tuşuna karşılık gelir.
FUNCTION İşlev meta tuşuna karşılık gelir.

Not: Bir özellikte birden fazla anahtar kelime belirtebilirsiniz. Örneğin, android:numericModifiers="CTRL|SHIFT", ilgili menü öğesini tetiklemek için kullanıcının kısayolla birlikte hem Control hem de Üst Karakter meta tuşlarına basması gerektiğini gösterir.

Özellik değerlerini programatik olarak ayarlamak için setNumericShortcut() yöntemini kullanabilirsiniz. numericModifier özelliği hakkında daha fazla bilgi için numericModifiers başlıklı makaleyi inceleyin.

android:checkable
Boole. Öğe işaretlenebiliyorsa True (Doğru) değerini döndürür.
android:checked
Boole. Öğe varsayılan olarak işaretliyse True değerini döndürür.
android:visible
Boole. Öğe varsayılan olarak görünürse doğru değerini döndürür.
android:enabled
Boole. Öğe varsayılan olarak etkinse True (Doğru) değerini döndürür.
android:menuCategory
Anahtar kelime. Öğenin önceliğini tanımlayan Menu CATEGORY_* sabitlerine karşılık gelen değer. Geçerli değerler:
DeğerAçıklama
containerBir kapsayıcının parçası olan öğeler için.
systemSistem tarafından sağlanan öğeler için.
secondaryKullanıcı tarafından sağlanan ikincil (seyrek kullanılan) seçenekler için kullanılır.
alternativeBu öğeler, o anda gösterilen veriler üzerinde alternatif işlemlerdir.
android:orderInCategory
Tam sayı. Öğenin bir grup içindeki önem sırası.
<group>
Görünür, etkin veya seçilebilir olma gibi özellikleri paylaşan öğelerden oluşan bir koleksiyon oluşturmak için menü grubu. Bir veya daha fazla <item> öğesi içeriyor. <menu> öğesinin alt öğesi olmalıdır.

Özellikler:

android:id
Kaynak kimliği. Benzersiz bir kaynak kimliği. Bu öğe için yeni bir kaynak kimliği oluşturmak istiyorsanız şu biçimi kullanın: "@+id/name". Artı simgesi, bunun yeni bir kimlik olarak oluşturulduğunu gösterir.
android:checkableBehavior
Anahtar kelime. Grup için seçilebilir davranış türü. Geçerli değerler:
DeğerAçıklama
noneSeçilemez.
allTüm öğeler seçilebilir (onay kutularını kullanın).
singleYalnızca bir öğe seçilebilir (radyo düğmeleri kullanılır).
android:visible
Boole. Grup görünürse doğru değerini döndürür.
android:enabled
Boole. Grup etkinse True (Doğru) değerini alır.
android:menuCategory
Anahtar kelime. Grubun önceliğini tanımlayan Menu CATEGORY_* sabitlerine karşılık gelen değer. Geçerli değerler:
DeğerAçıklama
containerBir kapsayıcının parçası olan gruplar için.
systemSistem tarafından sağlanan gruplar için.
secondaryKullanıcı tarafından sağlanan ikincil (seyrek kullanılan) seçenekler olan gruplar için.
alternativeŞu anda gösterilen veriler üzerinde alternatif işlemler olan gruplar için.
android:orderInCategory
Tam sayı. Kategorideki öğelerin varsayılan sırası.
örnek:
XML dosyası res/menu/example_menu.xml konumuna kaydedildi:
<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>

Aşağıdaki uygulama kodu, onCreateOptionsMenu(Menu) geri çağırma işlevinden menüyü genişletir ve iki öğe için tıklama geri çağırma işlevini de bildirir:

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.
}