本頁面由 Cloud Translation API 翻譯而成。

新增菜單

選單是一種適用於多種應用程式的常見使用者介面元件。為了提供熟悉且一致的使用者體驗，請在活動中使用 Menu API 為使用者呈現動作和其他選項。

顯示溢出選單示例的圖片 — **圖 1.** 輕觸圖示觸發的選單，會顯示在溢位選單圖示下方。

本文件說明如何在所有版本的 Android 上建立三種基本選單類型或操作的呈現：

選項選單和應用程式列

選項選單是一項活動的選單項目主集合。在這裡，您應該放置會對應用程式造成全域影響的操作，例如「搜尋」、「撰寫電子郵件」和「設定」。

請參閱「建立選項選單」一節。

內容選單及關聯動作模式

內容選單是一種浮動式選單，會在使用者按住元素時顯示。這提供的一些操作會影響所選的內容或內容畫面。

關聯動作模式會在螢幕頂端的列中顯示會影響所選內容的操作項目，並允許使用者選取多個選項。

請參閱「建立內容選單」一節。

彈出式選單

彈出式選單會以垂直清單的方式顯示一列項目，該清單會固定在呼叫出選單的檢視畫面中。這有助於提供與特定內容相關的操作溢位，或為一項指令提供第二部分的選項。彈出式選單中的動作不會直接影響相對應的內容，這就是關聯動作的目的。相反地，彈出式選單適合在您的活動中，用來擴充與內容區域相關的操作。

請參閱「建立彈出式選單」一節。

在 XML 中定義選單

對於所有類型的選單，Android 都提供了標準的 XML 格式來定義選單項目。您不應在活動的程式碼中建立選單，而是應於 XML 選單資源中定義選單及其所有項目。接著即可在活動或片段中加載選單資源 (以 Menu 物件載入)。

使用選單資源是很好的做法，原因在於：

在 XML 中可以更簡單明暸地看到選單結構。
這會區隔選單內容與應用程式的行為程式碼。
透過這個應用程式資源架構，可為不同的平台版本、螢幕大小和其他設定，建立不同的選單設定。

如要定義選單，請在專案的 res/menu/ 目錄中建立 XML 檔案，然後以下列元素建立選單：

<menu>: 定義一個 Menu，這是選單項目使用的容器。<menu> 元素必須是檔案的根節點，且可包含一或多個 <item> 和 <group> 元素。
<item>: 建立 MenuItem，用來表示選單中的單一項目。此元素可包含巢狀結構的 <menu> 元素，用來建立子選單。
<group>: 用於 <item> 元素的選擇性隱藏容器。可用來對選單項目進行分類，使其可以共用諸多屬性，例如活動狀態及瀏覽權限等。詳情請參閱「建立選單群組」一節。

以下是名為 game_menu.xml 的選單範例：

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:id="@+id/new_game"
          android:icon="@drawable/ic_new_game"
          android:title="@string/new_game"
          app:showAsAction="ifRoom"/>
    <item android:id="@+id/help"
          android:icon="@drawable/ic_help"
          android:title="@string/help" />
</menu>

<item> 元素支援多種屬性，可用來定義項目的外觀和行為。上述選單中的項目包含下列屬性：

android:id: 項目專屬的資源 ID，可讓使用者在選取時，讓應用程式識別出該項目。
android:icon: 可繪項目的參照，用來做為項目的圖示。
android:title: 字串的參照，用來作為項目標題。
android:showAsAction: 此項目在應用程式列中顯示為操作項目的時間和方式。

這些是您應該使用的最重要屬性，不過還有更多屬性可用。如需所有支援屬性的相關資訊，請參閱選單資源說明文件。

您可以新增 <menu> 元素做為 <item> 的子項，即可在任何選單中為項目新增子選單。如果應用程式有許多功能可以依主題分類，就如同電腦應用程式選單列中的各個項目 (「檔案」、「編輯」和「檢視」)，就可以用到子選單。請參閱以下範例：

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:id="@+id/file"
          android:title="@string/file" >
        <!-- "file" submenu -->
        <menu>
            <item android:id="@+id/create_new"
                  android:title="@string/create_new" />
            <item android:id="@+id/open"
                  android:title="@string/open" />
        </menu>
    </item>
</menu>

如要在活動中使用選單，請「加載」選單資源，使用 MenuInflater.inflate() 將 XML 資源轉換為可編寫程式的物件。以下各節將說明如何為每種選單類型加載選單。

選項選單 (如圖 1 所示) 可用來加入與目前活動情境相關的操作和其他選項，例如「搜尋」、「撰寫電子郵件」和「設定」。

圖片：顯示 Google 試算表應用程式選單列 — **圖 2.** Google 試算表應用程式，顯示了多個按鈕，包括動作溢位按鈕在內。

您可以從 Activity 子類別或 Fragment 子類別中宣告選項選單的項目。如果您的活動和片段都宣告了選項選單的項目，使用者介面會將這些項目合併。活動的項目會先顯示，接著依照片段加入活動的順序顯示各個片段的項目。如有需要，您可以在每個需要移動的 <item> 中使用 android:orderInCategory 屬性重新排序選單項目。

如要指定活動的選項選單，請覆寫 onCreateOptionsMenu()。片段會提供自己的 onCreateOptionsMenu() 回呼。使用此方法時，您可以將以 XML 定義的選單資源加載至回呼提供的 Menu 中。例如：

Kotlin

override fun onCreateOptionsMenu(menu: Menu): Boolean {
    val inflater: MenuInflater = menuInflater
    inflater.inflate(R.menu.game_menu, menu)
    return true
}

Java

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    MenuInflater inflater = getMenuInflater();
    inflater.inflate(R.menu.game_menu, menu);
    return true;
}

您也可以利用 add() 新增選單項目，並利用 findItem() 擷取項目來修改其與 MenuItem API 關聯的屬性。

處理點擊事件

當使用者從選項選單中選取項目 (包括應用程式列中的動作項目) 時，系統會呼叫活動的 onOptionsItemSelected() 方法。此方法會傳遞所選的 MenuItem。您可以藉由呼叫 getItemId() 確認該項目，這會回傳選單項目的專屬 ID (由選單資源中的 android:id 屬性所定義，或是向 add() 方法指定一個整數)。您可以將此 ID 與已知的選單項目進行比對，以執行適當的操作。

Kotlin

override fun onOptionsItemSelected(item: MenuItem): Boolean {
    // Handle item selection.
    return when (item.itemId) {
        R.id.new_game -> {
            newGame()
            true
        }
        R.id.help -> {
            showHelp()
            true
        }
        else -> super.onOptionsItemSelected(item)
    }
}

Java

@Override
public boolean onOptionsItemSelected(MenuItem item) {
    // Handle item selection.
    switch (item.getItemId()) {
        case R.id.new_game:
            newGame();
            return true;
        case R.id.help:
            showHelp();
            return true;
        default:
            return super.onOptionsItemSelected(item);
    }
}

成功處理選單項目後，將 true 傳回。如果您不處理選單項目，請呼叫 onOptionsItemSelected() 的父類別實作。預設實作會傳回 false。

如果活動中含有片段，系統會先針對活動呼叫 onOptionsItemSelected()，接著針對每個片段呼叫 (依片段加入的順序)，直到一個呼叫回傳 true 或所有片段均被呼叫為止。

提示：如果您的應用程式具有多項活動，而其中部分使用的是相同的選項選單，請考慮建立一個僅執行 onCreateOptionsMenu() 和 onOptionsItemSelected() 方法的活動。接著，將這個類別擴充給每個共用相同選項選單的活動使用。這樣一來，您就可以管理一組用來處理選單操作的程式碼，而每個子類別都可繼承這個選單行為。如果您想為其中一個子活動新增選單項目，請在該活動中覆寫 >onCreateOptionsMenu()。呼叫 super.onCreateOptionsMenu(menu) 即可建立原始選單項目，接著以 menu.add() 新增選單項目。您也可以為個別選單項目覆寫超類別的行為。

在執行階段變更選單項目

系統呼叫 onCreateOptionsMenu() 後，會保留您填入的 Menu 執行個體，除非該選單失效，否則不會再次呼叫 onCreateOptionsMenu()。不過，建議您只將 onCreateOptionsMenu() 用於建立初始選單狀態，不要在活動生命週期內進行變更。

如要依據活動生命週期中發生的事件修改選項選單，可以使用 onPrepareOptionsMenu() 方法。此方法會向您傳遞目前存在的 Menu 物件，因此您可以加以修改，例如新增、移除或停用項目。片段也會提供 onPrepareOptionsMenu() 回呼。

當應用程式列顯示選單項目時，選項選單會一律開啟。當事件發生且您想要更新選單時，請呼叫 invalidateOptionsMenu() 以要求系統呼叫 onPrepareOptionsMenu()。

注意：請勿根據焦點所在的 View 變更選項選單中的項目。在輕觸模式中 (當使用者未使用軌跡球或 D-pad 時) 檢視畫面無法取得焦點，因此，因此您不應以焦點做為修改選項選單中項目的基礎。如要提供依 View 內容而定的選單項目，請使用內容選單，如以下章節所述。

內容選單可提供會影響使用者介面中特定項目或內容畫面的操作。您可以為任何檢視畫面提供內容選單，但它們通常用於 RecylerView 或其他使用者可以直接對各個項目進行操作的檢視畫面集合。

提供內容關聯操作的方法有兩種：

在浮動內容選單中。當使用者在宣告支援內容選單的檢視畫面上按住畫面時，選單就會以浮動式清單的方式顯示選單項目 (類似於對話方塊)。使用者一次可以對一個項目執行內容關聯操作。
在關聯動作模式中。此模式是系統執行 ActionMode 的作法，會在畫面頂端顯示關聯動作列(或 CAB)，其中包含會影響所選項目的操作項目。啟用此模式時，如果應用程式支援，使用者一次可對多個項目執行一項操作。

注意： 內容功能表不支援項目捷徑和項目圖示。

建立浮動內容選單

如要提供浮動內容選單，請按照下列步驟操作：

呼叫 registerForContextMenu() 並傳遞 View，以註冊與內容選單相關的 View。
如果您的活動使用 RecyclerView，且您希望每個項目都提供相同的內容選單，那麼請將 RecyclerView 傳遞到 registerForContextMenu()，以註冊內容選單的所有項目。

在 Activity 或 Fragment 中實作 onCreateContextMenu() 方法。

當註冊的檢視區塊收到觸控與按住事件時，系統會呼叫您的 onCreateContextMenu() 方法。您可以在此定義選單項目，作法通常為加載一個選單資源，如以下範例所示：

Kotlin

    override fun onCreateContextMenu(menu: ContextMenu, v: View,
                            menuInfo: ContextMenu.ContextMenuInfo) {
        super.onCreateContextMenu(menu, v, menuInfo)
        val inflater: MenuInflater = menuInflater
        inflater.inflate(R.menu.context_menu, menu)
    }

Java

    @Override
    public void onCreateContextMenu(ContextMenu menu, View v,
                                    ContextMenuInfo menuInfo) {
        super.onCreateContextMenu(menu, v, menuInfo);
        MenuInflater inflater = getMenuInflater();
        inflater.inflate(R.menu.context_menu, menu);
    }

MenuInflater 可讓您從選單資源中加載內容選單。回呼方法參數包括使用者選用的 View，以及可提供與選取項目相關額外資訊的 ContextMenu.ContextMenuInfo 物件。如果活動有多個檢視畫面，且每個檢視畫面提供不同的內容選單，您可以利用這些參數來判斷要加載哪些內容選單。

實作 onContextItemSelected()，如以下範例所示。當使用者選取選單項目時，系統會呼叫此方法，讓您執行適當的動作。

Kotlin

    override fun onContextItemSelected(item: MenuItem): Boolean {
        val info = item.menuInfo as AdapterView.AdapterContextMenuInfo
        return when (item.itemId) {
            R.id.edit -> {
                editNote(info.id)
                true
            }
            R.id.delete -> {
                deleteNote(info.id)
                true
            }
            else -> super.onContextItemSelected(item)
        }
    }

Java

    @Override
    public boolean onContextItemSelected(MenuItem item) {
        AdapterContextMenuInfo info = (AdapterContextMenuInfo) item.getMenuInfo();
        switch (item.getItemId()) {
            case R.id.edit:
                editNote(info.id);
                return true;
            case R.id.delete:
                deleteNote(info.id);
                return true;
            default:
                return super.onContextItemSelected(item);
        }
    }

getItemId() 方法會查詢所選選單項目的 ID，您應該使用 android:id 屬性以 XML 為每個選單項目進行指派，如以 XML 定義選單一節所述。

成功處理選單項目後，將 true 傳回。如果您不處理選單項目，請將選單項目傳遞至父類別實作項目。如果您的活動含有片段，活動會先收到此回呼。在未處理的情況下呼叫父類別時，系統會依序將事件傳遞到每個片段的相應回呼方法，每次傳遞一個，直至傳回 true 或 false 為止。Activity 和 android.app.Fragment 的預設實作會傳回 false，因此請在未處理時一律呼叫父類別。

使用關聯動作模式

關聯動作模式是 ActionMode 的系統實作，著重於將使用者互動轉為執行關聯操作。當使用者選取某個項目啟用此模式時，螢幕頂端會出現關聯動作列，以顯示使用者可以對所選項目執行的操作。啟用此模式後，使用者可以選取多個項目 (如果應用程式支援的話)，並取消選取項目，以及繼續在活動中瀏覽。當使用者取消選取所有項目、輕觸「返回」按鈕，或是輕觸列左側的「完成」動作時，操作模式即會停用，關聯動作列會消失。

針對提供內容關聯操作的檢視畫面，通常應在兩個事件之一 (或兩者) 上叫用關聯動作模式：

使用者按住檢視畫面。
使用者在檢視畫面中選取核取方塊或類似的 UI 元件。

您的設計決定了應用程式如何叫用關聯動作模式，並定義每個動作的行為。有兩種設計：

用於個別任意檢視畫面的內容關聯操作。
用於 RecyclerView 中對項目群組進行批次關聯操作，讓使用者選取多個項目並對其執行操作。

以下章節將說明第一個情境所需的設定。

為個別檢視畫面啟用關聯動作模式

如果只想在使用者選取特定檢視畫面時叫用關聯動作模式，請採取下列做法：

實作 ActionMode.Callback 介面，如以下範例所示。在回呼方法中，您可以指定關聯動作列的操作、回應操作項目的點擊事件，以及處理操作模式的其他生命週期事件。

Kotlin

    private val actionModeCallback = object : ActionMode.Callback {
        // Called when the action mode is created. startActionMode() is called.
        override fun onCreateActionMode(mode: ActionMode, menu: Menu): Boolean {
            // Inflate a menu resource providing context menu items.
            val inflater: MenuInflater = mode.menuInflater
            inflater.inflate(R.menu.context_menu, menu)
            return true
        }

        // Called each time the action mode is shown. Always called after
        // onCreateActionMode, and might be called multiple times if the mode
        // is invalidated.
        override fun onPrepareActionMode(mode: ActionMode, menu: Menu): Boolean {
            return false // Return false if nothing is done
        }

        // Called when the user selects a contextual menu item.
        override fun onActionItemClicked(mode: ActionMode, item: MenuItem): Boolean {
            return when (item.itemId) {
                R.id.menu_share -> {
                    shareCurrentItem()
                    mode.finish() // Action picked, so close the CAB.
                    true
                }
                else -> false
            }
        }

        // Called when the user exits the action mode.
        override fun onDestroyActionMode(mode: ActionMode) {
            actionMode = null
        }
    }

Java

    private ActionMode.Callback actionModeCallback = new ActionMode.Callback() {

        // Called when the action mode is created. startActionMode() is called.
        @Override
        public boolean onCreateActionMode(ActionMode mode, Menu menu) {
            // Inflate a menu resource providing context menu items.
            MenuInflater inflater = mode.getMenuInflater();
            inflater.inflate(R.menu.context_menu, menu);
            return true;
        }

        // Called each time the action mode is shown. Always called after
        // onCreateActionMode, and might be called multiple times if the mode
        // is invalidated.
        @Override
        public boolean onPrepareActionMode(ActionMode mode, Menu menu) {
            return false; // Return false if nothing is done.
        }

        // Called when the user selects a contextual menu item.
        @Override
        public boolean onActionItemClicked(ActionMode mode, MenuItem item) {
           switch (item.getItemId()) {
                case R.id.menu_share:
                    shareCurrentItem();
                    mode.finish(); // Action picked, so close the CAB.
                    return true;
                default:
                    return false;
            }
        }

        // Called when the user exits the action mode.
        @Override
        public void onDestroyActionMode(ActionMode mode) {
            actionMode = null;
        }
    };

這些事件回呼與選項選單中的回呼幾乎相同，唯每個回呼也會傳送與事件相關的 ActionMode 物件。您可以使用 ActionMode API 對 CAB 進行多項變更，例如利用 setTitle() 和 setSubtitle() 修改標題和副標題 (可用來指出已選取的項目數量)。

在上述範例中，刪除操作模式時，會將 actionMode 變數設為 null。在下一個步驟中，您將瞭解其初始化的方式，以及在活動或片段中儲存成員變數的好處。

如要顯示列，請呼叫 startActionMode()，例如在使用者按住檢視畫面時。

Kotlin

    someView.setOnLongClickListener { view ->
        // Called when the user performs a touch & hold on someView.
        when (actionMode) {
            null -> {
                // Start the CAB using the ActionMode.Callback defined earlier.
                actionMode = activity?.startActionMode(actionModeCallback)
                view.isSelected = true
                true
            }
            else -> false
        }
    }

Java

    someView.setOnLongClickListener(new View.OnLongClickListener() {
        // Called when the user performs a touch & hold on someView.
        public boolean onLongClick(View view) {
            if (actionMode != null) {
                return false;
            }

            // Start the CAB using the ActionMode.Callback defined earlier.
            actionMode = getActivity().startActionMode(actionModeCallback);
            view.setSelected(true);
            return true;
        }
    });

當您呼叫 startActionMode() 時，系統會傳回建立的 ActionMode。將此項目儲存至成員變數中，即可變更關聯動作列以回應其他事件。在上例範例中，ActionMode 是用來確保在活動期間不會重新建立 ActionMode 執行個體，方法是先檢查成員的值是否為空值，接著再啟用操作模式。

建立彈出式選單

圖片顯示 Gmail 應用程式中的彈出式選單，其固定在右上方的溢位按鈕上。 — **圖 4.** Gmail 應用程式中的彈出式選單，固定在右上角的溢位按鈕上。

PopupMenu 是固定在 View 上的模式選單。如果有空間，它或顯示在錨定檢視畫面下方，或是在檢視畫面上方。這項功能適用於以下情況：

為與特定內容 (例如圖 4 中顯示的 Gmail 電子郵件標頭) 相關的操作提供溢位樣式選單。
注意：這與內容選單不同，通常是用以影響所選內容的操作。針對會影響所選內容的操作，請使用關聯動作模式或浮動內容選單。
提供指令句的第二部分，例如標示「Add」的按鈕，可產生包含不同「Add」選項的彈出式選單。
提供類似 Spinner 的選單，但不會保留永久選項。

如果您以 XML 定義選單，您可以按照下列步驟顯示彈出式選單：

利用其建構函式將 PopupMenu 執行個體化，此操作會將目前應用程式的 Context 和 View 帶到選單應該錨定的地方。
使用 MenuInflater 將選單資源加載至 PopupMenu.getMenu() 傳回的 Menu 物件。
呼叫 PopupMenu.show()。

舉例來說，以下按鈕會顯示彈出式選單：

<ImageButton
    android:id="@+id/dropdown_menu"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:contentDescription="@string/descr_overflow_button"
    android:src="@drawable/arrow_drop_down" />

這項活動隨即會顯示如下的彈出式選單：

Kotlin

findViewById<ImageButton>(R.id.dropdown_menu).setOnClickListener {
    val popup = PopupMenu(this, it)
    val inflater: MenuInflater = popup.menuInflater
    inflater.inflate(R.menu.actions, popup.menu)
    popup.show()
}

Java

findViewById(R.id.dropdown_menu).setOnClickListener(v -> {
    PopupMenu popup = new PopupMenu(this, v);
    popup.getMenuInflater().inflate(R.menu.actions, popup.getMenu());
    popup.show();
});

當使用者選取項目或輕觸選單區域之外的區域時，選單就會關閉。您可以使用 PopupMenu.OnDismissListener 監聽關閉事件。

處理點擊事件

如要在使用者選取選單項目時執行動作，請實作 PopupMenu.OnMenuItemClickListener 介面，並呼叫 setOnMenuItemclickListener() 將其註冊到 PopupMenu。使用者選取項目時，系統會在介面中呼叫 onMenuItemClick() 回呼。

例如：

Kotlin

fun showMenu(v: View) {
    PopupMenu(this, v).apply {
        // MainActivity implements OnMenuItemClickListener.
        setOnMenuItemClickListener(this@MainActivity)
        inflate(R.menu.actions)
        show()
    }
}

override fun onMenuItemClick(item: MenuItem): Boolean {
    return when (item.itemId) {
        R.id.archive -> {
            archive(item)
            true
        }
        R.id.delete -> {
            delete(item)
            true
        }
        else -> false
    }
}

Java

public void showMenu(View v) {
    PopupMenu popup = new PopupMenu(this, v);

    // This activity implements OnMenuItemClickListener.
    popup.setOnMenuItemClickListener(this);
    popup.inflate(R.menu.actions);
    popup.show();
}

@Override
public boolean onMenuItemClick(MenuItem item) {
    switch (item.getItemId()) {
        case R.id.archive:
            archive(item);
            return true;
        case R.id.delete:
            delete(item);
            return true;
        default:
            return false;
    }
}

建立選單群組

選單群組是指一組共用特定特色的選單項目集合。您可以透過群組執行下列操作：

使用 setGroupVisible() 顯示或隱藏所有項目。
使用 setGroupEnabled() 啟用或停用所有項目。
指定是否可使用 setGroupCheckable() 核選所有項目。

您可以在選單資源中的 <group> 元素內建立巢狀結構 <item> 元素，以此建立一個群組，或透過 add() 方法指定群組 ID。

以下是含有群組的選單資源範例：

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:id="@+id/menu_save"
          android:icon="@drawable/menu_save"
          android:title="@string/menu_save" />
    <!-- menu group -->
    <group android:id="@+id/group_delete">
        <item android:id="@+id/menu_archive"
              android:title="@string/menu_archive" />
        <item android:id="@+id/menu_delete"
              android:title="@string/menu_delete" />
    </group>
</menu>

群組中的項目會與第一個項目顯示同一級別，選單中所有三個項目均為同層級。不過，您可以參照群組 ID 並使用上述方法修改群組中兩個項目的特性。系統也不會將同一群組的項目分開。舉例來說，如果您為每個項目宣告 android:showAsAction="ifRoom"，這兩者會同時顯示在動作列上，或同時顯示在溢位操作中。

使用可勾選的選單項目

圖 5. 子選單，其中包含可勾選的項目。

選單對於開啟和關閉選項來說是很實用的介面，核取方塊則用於獨立選項，而互斥選項的群組則可使用圓形按鈕。圖 5 顯示的是可透過圓形按鈕勾選項目的子選單。

您可以使用 <item> 元素中的 android:checkable 屬性定義個別選單項目的可核取行為，或是在 <group> 元素中使用 android:checkableBehavior 屬性為整個群組定義。舉例來說，此選單群組中的所有項目皆可以使用圓形按鈕勾選：

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android">
    <group android:checkableBehavior="single">
        <item android:id="@+id/red"
              android:title="@string/red" />
        <item android:id="@+id/blue"
              android:title="@string/blue" />
    </group>
</menu>

android:checkableBehavior 屬性可接受下列其中一個：

single: 只能勾選群組中的一個項目，因此會產生圓形按鈕。
all: 所有項目均可勾選，因此會顯示核取方塊。
none: 沒有可勾選的項目。

您可以透過 <item> 元素中的 android:checked 屬性，將某個項目預設為勾選狀態，接著用 setChecked() 方法在程式碼中變更。

如果選取了一個可勾選項目，系統會呼叫所選項目的回呼方法 (例如 onOptionsItemSelected())。您必須在此設定核取方塊的狀態，因為核取方塊或圓形按鈕不會自動變更狀態。您可以使用 isChecked() 查詢項目目前的狀態 (也就是使用者選取該項目前的狀態)，接著使用 setChecked() 將其狀態設定為已勾選。如以下範例所示：

Kotlin

override fun onOptionsItemSelected(item: MenuItem): Boolean {
    return when (item.itemId) {
        R.id.vibrate, R.id.dont_vibrate -> {
            item.isChecked = !item.isChecked
            true
        }
        else -> super.onOptionsItemSelected(item)
    }
}

Java

@Override
public boolean onOptionsItemSelected(MenuItem item) {
    switch (item.getItemId()) {
        case R.id.vibrate:
        case R.id.dont_vibrate:
            if (item.isChecked()) item.setChecked(false);
            else item.setChecked(true);
            return true;
        default:
            return super.onOptionsItemSelected(item);
    }
}

如果您未以這種方式設定勾選狀態，則使用者選取核取方塊或圓形按鈕時，視覺上的狀態不會改變。若您設定了狀態，活動會保留項目勾選的狀態，因此當使用者之後開啟選單時，就可以看到您設定的已勾選狀態。

根據意圖新增選單項目

有時候，您可能想讓選單項目使用 Intent 啟動活動，無論是您應用程式或其他應用程式中的活動。如果您知道要使用的意圖為何，而且具有可啟動該意圖的特定選單項目，就可以在適當的選取項目回呼方法 (例如 onOptionsItemSelected() 回呼) 中，使用 startActivity() 執行意圖。

然而，如果您不確定使用者裝置是否具有會處理該意圖的應用程式，那麼新增會叫用該意圖的選單項目，可能會導致選單項目無法運作，因為該意圖可能無法解析活動。為解決此問題，當 Android 在處理您的意圖的裝置上找到活動時，您可透過動態的方式將選單項目加入選單。

如要根據可接受意圖的活動新增選單項目，請執行下列操作：

將意圖定義為類別 CATEGORY_ALTERNATIVE 或 CATEGORY_SELECTED_ALTERNATIVE，或兩者皆是，以及任何其他要求。
呼叫 Menu.addIntentOptions()。Android 會搜尋可執行這項意圖的應用程式，並將應用程式加入選單。

如果沒有安裝任何符合這項意圖的應用程式，系統就不會新增選單項目。

注意： CATEGORY_SELECTED_ALTERNATIVE 用於處理螢幕上選取的元素。只有在 onCreateContextMenu() 中建立選單時才能使用。

例如：

Kotlin

override fun onCreateOptionsMenu(menu: Menu): Boolean {
    super.onCreateOptionsMenu(menu)

    // Create an Intent that describes the requirements to fulfill, to be
    // included in the menu. The offering app must include a category value
    // of Intent.CATEGORY_ALTERNATIVE.
    val intent = Intent(null, dataUri).apply {
        addCategory(Intent.CATEGORY_ALTERNATIVE)
    }

    // Search and populate the menu with acceptable offering apps.
    menu.addIntentOptions(
            R.id.intent_group,  // Menu group to which new items are added.
            0,                  // Unique item ID (none).
            0,                  // Order for the items (none).
            this.componentName, // The current activity name.
            null,               // Specific items to place first (none).
            intent,             // Intent created above that describes the requirements.
            0,                  // Additional flags to control items (none).
            null)               // Array of MenuItems that correlate to specific items (none).

    return true
}

Java

@Override
public boolean onCreateOptionsMenu(Menu menu){
    super.onCreateOptionsMenu(menu);

    // Create an Intent that describes the requirements to fulfill, to be
    // included in the menu. The offering app must include a category value
    // of Intent.CATEGORY_ALTERNATIVE.
    Intent intent = new Intent(null, dataUri);
    intent.addCategory(Intent.CATEGORY_ALTERNATIVE);

    // Search and populate the menu with acceptable offering apps.
    menu.addIntentOptions(
         R.id.intent_group,         // Menu group to which new items are added.
         0,                         // Unique item ID (none).
         0,                         // Order for the items (none).
         this.getComponentName(),   // The current activity name.
         null,                      // Specific items to place first (none).
         intent,                    // Intent created above that describes the requirements.
         0,                         // Additional flags to control items (none).
         null);                     // Array of MenuItems that correlate to specific items (none).

    return true;
}

系統會找到提供意圖篩選器並符合所定義意圖的每個活動，並為其新增選單項目，以意圖篩選器的 android:label 值做為選單項目標題，並以應用程式圖示做為選單的項目圖示。addIntentOptions() 方法會傳回新增的選單項目數量。

注意：在呼叫 addIntentOptions() 時，系統會以第一個引數中指定的選單群組，覆寫選單中的所有項目。

將活動新增至其他選單

您可以將活動服務提供給其他應用程式，讓您的應用程式可納入其他應用程式的選單中，也就是將上述角色反轉過來。

如要加至其他應用程式的選單中，請一如往常定義意圖篩選器，但請務必加入意圖篩選器類別的 CATEGORY_ALTERNATIVE 或 CATEGORY_SELECTED_ALTERNATIVE 值，或兩者皆加入。例如：

<intent-filter label="@string/resize_image">
    ...
    <category android:name="android.intent.category.ALTERNATIVE" />
    <category android:name="android.intent.category.SELECTED_ALTERNATIVE" />
    ...
</intent-filter>

如要進一步瞭解如何編寫意圖篩選器，請參閱「意圖和意圖篩選器」一文。

新增菜單 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

在 XML 中定義選單

建立選項選單

Kotlin

Java

處理點擊事件

Kotlin

Java

在執行階段變更選單項目

建立內容選單

建立浮動內容選單

Kotlin

Java

Kotlin

Java

使用關聯動作模式

為個別檢視畫面啟用關聯動作模式

Kotlin

Java

Kotlin

Java

建立彈出式選單

Kotlin

Java

處理點擊事件

Kotlin

Java

建立選單群組

使用可勾選的選單項目

Kotlin

Java

根據意圖新增選單項目

Kotlin

Java

將活動新增至其他選單

新增菜單