Ta strona została przetłumaczona przez Cloud Translation API.

Zasób menu

Zasób menu definiuje menu aplikacji (menu opcji, menu kontekstowe lub podmenu), które można powiększyć za pomocą MenuInflater.

Wskazówki dotyczące korzystania z menu znajdziesz w artykule Dodawanie menu.

lokalizacja pliku:

res/menu/filename.xml) Nazwa pliku jest używana jako identyfikator zasobu

skompilowany typ danych zasobu:

Wskaźnik zasobu do zasobu Menu (lub podklasy)

odniesienie do zasobu:

W języku Java: R.menu.filename
W pliku XML: @[package:]menu.filename

składnia:

<?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>

elementy:

<menu>

Wymagane. Musi to być węzeł główny. Zawiera <item> lub <group> elementów.

Atrybuty:

xmlns:android: Przestrzeń nazw XML. Wymagane. Definiuje przestrzeń nazw XML, która musi wynosić "http://schemas.android.com/apk/res/android".

<item>

Pozycja w menu. Może zawierać element <menu> (dotyczy menu podrzędnego). Musi być elementem podrzędnym elementu <menu> lub <group>.

Atrybuty:

android:id

Identyfikator zasobu. Unikalny identyfikator zasobu. Aby utworzyć nowy identyfikator zasobu dla tego elementu, użyj formularza: "@+id/name" Symbol plusa oznacza, że jest ona utworzona jako nowy ID.

android:title

Zasób ciągu znaków. Tytuł menu w postaci zasobu tekstowego lub nieprzetworzonego ciągu znaków.

android:titleCondensed

Zasób ciągu znaków. Skrócony tytuł w postaci zasobu tekstowego lub nieprzetworzonego ciągu. Ten tytuł jest używany w sytuacjach, gdy zwykły tytuł jest za długi.

android:icon

Zasób rysowalny. Obraz, który ma służyć jako ikona pozycji menu.

android:onClick

Nazwa metody. Metoda wywoływania po kliknięciu tego elementu menu. musi być zadeklarowana w aktywności jako publiczna. Akceptuje ona MenuItem jako , który wskazuje kliknięty element. Ta metoda ma pierwszeństwo przed standardową metodą oddzwanianie do onOptionsItemSelected(). Zobacz na końcu tej strony.

Ostrzeżenie: jeśli zaciemniasz kod za pomocą ProGuard lub podobnego narzędzia, pamiętaj, aby wykluczyć metodę określoną w tym atrybucie ze zmiany nazwy, ponieważ może to spowodować funkcji.

Wprowadzono w interfejsie API poziomu 11.

android:showAsAction

Słowo kluczowe. Kiedy i jak ten element pojawia się jako działanie w aplikacji przeglądarki. Działanie w menu może się pojawić tylko wtedy, gdy aktywność zawiera na pasku aplikacji. Prawidłowe wartości:

Wartość	Opis
`ifRoom`	Umieść ten element tylko w pasek aplikacji, o ile jest na to miejsce. Jeśli nie ma miejsca dla wszystkich elementy oznaczone etykietą `"ifRoom"`, czyli elementy z najniższą Wartości `orderInCategory` są wyświetlane jako działania, Pozostałe elementy wyświetlają się w rozszerzonym menu.
`withText`	Dołącz też tekst tytułu (zdefiniowany do `android:title`) z działaniem. Możesz podać tę wartość razem z jednym pozostałych jako flagę, oddzielając je pionową kreską `\|`.
`never`	Nigdy nie umieszczaj tego elementu na pasku aplikacji. Zamiast tego wymień element w rozszerzeniu paska aplikacji .
`always`	Zawsze umieszczaj ten element na pasku aplikacji. Nie używaj jej, chyba że jest konieczne, aby element zawsze pojawiał się w działaniu przeglądarki. Jeśli ustawisz kilka elementów tak, by były zawsze widoczne jako działania, mogą się one nakładać z innym interfejsem na pasku aplikacji.
`collapseActionView`	Powiązany widok działań z tym działaniem (zgodnie z deklaracją `android:actionLayout` lub `android:actionViewClass`) to zwijane. Wprowadzono w interfejsie API na poziomie 14.

Zobacz Dodawanie paska aplikacji. .

Wprowadzono w interfejsie API poziomu 11.

android:actionLayout

Zasób układu. Układ używany jako widok działań.

Więcej informacji znajdziesz w artykule Korzystanie z działania dostawców wyświetleń i działań.

Wprowadzono w interfejsie API poziomu 11.

android:actionViewClass

Nazwa zajęć. Pełna i jednoznaczna nazwa zajęć dla: View który ma być używany jako widok działań. Przykład: "android.widget.SearchView", aby użyć widoku SearchView jako widoku działań.

Więcej informacji znajdziesz w artykule Korzystanie z działania dostawców wyświetleń i działań.

Ostrzeżenie: jeśli zaciemniasz kod za pomocą ProGuard lub podobnego narzędzia, pamiętaj, aby wykluczyć klasę określoną w tym atrybucie ze zmiany nazwy, ponieważ może to spowodować uszkodzenie funkcji.

Wprowadzono w interfejsie API poziomu 11.

android:actionProviderClass

Nazwa zajęć. Pełna i jednoznaczna nazwa klasy, której ActionProvider ma używać zamiast działania. Przykład: "android.widget.ShareActionProvider", aby użyć aplikacji ShareActionProvider.

Więcej informacji znajdziesz w artykule Korzystanie z działania dostawców wyświetleń i działań.

Wprowadzono w interfejsie API poziomu 14.

android:alphabeticShortcut

Char. Znak alfabetycznego klawisza skrótu.

android:numericShortcut

Liczba całkowita. Liczba będąca cyfrą klawisza skrótu.

android:alphabeticModifiers

Słowo kluczowe. Modyfikator alfabetycznego elementu menu skrótu. Wartość domyślna odpowiada wartości Control . Prawidłowe wartości:

Wartość	Opis
`META`	Odpowiada meta klawiszowi `Meta`.
`CTRL`	Odpowiada klawiszowi meta `Control`.
`ALT`	Odpowiada klawiszowi meta `Alt`.
`SHIFT`	Odpowiada klawiszowi meta `Shift`.
`SYM`	Odpowiada meta klawiszowi `Sym`.
`FUNKCJA`	Odpowiada klawiszowi meta `Funkcja`.

Uwaga: w jednej kolumnie . Przykład: android:alphabeticModifiers="CTRL|SHIFT" oznacza aby aktywować odpowiednią pozycję menu, użytkownik musi naciśnij jednocześnie klawisze meta Control i Shift za pomocą skrótu.

Możesz użyć metody setAlphabeticShortcut() do: ustawiać wartości atrybutów w sposób automatyczny. Więcej informacji na temat konfiguracji o atrybucie alphabeticModifier, zobacz alphabeticModifiers

android:numericModifiers

Słowo kluczowe. Modyfikator skrótu liczbowego elementu menu. Wartość domyślna odpowiada klawiszowi Control. Prawidłowa wartości:

Wartość	Opis
`META`	Odpowiada meta klawiszowi `Meta`.
`CTRL`	Odpowiada klawiszowi meta `Control`.
`ALT`	Odpowiada klawiszowi meta `Alt`.
`SHIFT`	Odpowiada klawiszowi meta `Shift`.
`SYM`	Odpowiada meta klawiszowi `Sym`.
`FUNKCJA`	Odpowiada klawiszowi meta `Funkcja`.

Uwaga: w jednej kolumnie . Przykład: android:numericModifiers="CTRL|SHIFT" oznacza aby aktywować odpowiednią pozycję menu, użytkownik musi naciśnij jednocześnie klawisze meta Control i Shift za pomocą skrótu.

Aby ustawić, możesz użyć metody setNumericShortcut() wartości atrybutów. Więcej informacji na temat: numericModifier, zobacz numericModifiers

android:checkable

Wartość logiczna. Prawda, jeśli element jest możliwy do zaznaczenia.

android:checked

Wartość logiczna. Prawda, jeśli element jest domyślnie zaznaczony.

android:visible

Wartość logiczna. Prawda, jeśli element jest domyślnie widoczny.

android:enabled

Wartość logiczna. Prawda, jeśli element jest domyślnie włączony.

android:menuCategory

Słowo kluczowe. Wartość odpowiadająca Menu CATEGORY_* stałe, które określają priorytet elementu. Prawidłowe wartości:

Wartość	Opis
`container`	W przypadku elementów, które są częścią kontenera.
`system`	W przypadku produktów dostarczanych przez systemu.
`secondary`	W przypadku elementów, które zostały przekazane przez użytkownika jako dodatkowe (rzadko używane).
`alternative`	Elementy, które są działaniami alternatywnymi na obecnie wyświetlanych danych.

android:orderInCategory

Liczba całkowita. Kolejność ważności elementu w grupie.

<group>

Grupa menu umożliwiająca utworzenie kolekcji pozycji o wspólnych cechach, takich jak widoczne, włączone lub możliwe do wyboru. Zawiera co najmniej 1 element <item>. Musi to być element podrzędny elementu <menu>.

Atrybuty:

android:id

android:checkableBehavior

Słowo kluczowe. Typ działania, które można wybrać w przypadku grupy. Prawidłowe wartości:

Wartość	Opis
`none`	Nie można wybrać.
`all`	Możesz zaznaczyć wszystkie elementy (użyj pól wyboru).
`single`	Możesz wybrać tylko jeden element (użyj opcji ).

android:visible

Wartość logiczna. Prawda, jeśli grupa jest widoczna.

android:enabled

Wartość logiczna. Prawda, jeśli grupa jest włączona.

android:menuCategory

Słowo kluczowe. Wartość odpowiadająca Menu CATEGORY_* stałych, które określają priorytet grupy. Prawidłowe wartości:

Wartość	Opis
`container`	W przypadku grup, które są częścią kontenera.
`system`	W przypadku grup dostarczanych przez systemu.
`secondary`	Dla grup przekazanych przez użytkowników jako dodatkowych (rzadko używane).
`alternative`	Dla grup, które są działaniami alternatywnymi na obecnie wyświetlanych danych.

android:orderInCategory

Liczba całkowita. Domyślna kolejność elementów w kategorii.

przykład:

Plik XML zapisany o res/menu/example_menu.xml:

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

Poniższy kod aplikacji rozszerza menu z wywołania zwrotnego onCreateOptionsMenu(Menu) i deklaruje metodę kliknięcia zwrotny dla dwóch z tych elementów:

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