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

新增菜單

選單是多種應用程式常見的使用者介面元件。目的地：來提供使用者熟悉且一致的體驗將 Menu API 套用至會在活動中顯示使用者動作和其他選項。

，瞭解如何調查及移除這項存取權。

顯示溢位選單範例的圖片 — **圖 1.**由輕觸圖示觸發的選單 (顯示於溢位選單圖示下方)。

本文件說明如何建立三種基本類型的選單所有 Android 版本的動作簡報：

選項選單和應用程式列

選項選單是活動。請在這裡放置對全球影響力例如「搜尋」「撰寫電子郵件」和「設定」

請參閱建立選項選單專區。

內容選單及關聯動作模式

內容選單是一種浮動式選單這個對話方塊會在使用者輕觸畫面後顯示會保留元素這項服務提供的操作會影響所選的內容或內容畫面。

關聯動作模式會顯示會會影響畫面頂端列中所選的內容使用者選取多個項目

請參閱建立內容選單專區。

彈出式選單

彈出式選單顯示項目垂直清單，固定在就會看到叫用選單的檢視畫面很適合提供動作溢位或提供第二部分的選項加上指令在彈出式選單中的動作，不會直接影響這就是關聯動作的目的相反地彈出式選單適合用來擴充與您的活動。

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

以 XML 定義選單

對於所有選單類型，Android 都提供標準的 XML 格式來定義選單項目。與其在活動程式碼中建構選單，不如定義選單和 XML 中的所有項目選單資源。你可以接著加載選單資源，以 Menu 形式載入該資源物件) 檔案。

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

在 XML 中可以更簡單明暸地看到選單結構。
可將選單內容與應用程式行為分開再也不是件繁重乏味的工作
可讓你為不同平台建立替代選單設定版本、螢幕大小和其他設定應用程式資源這個架構的重點在於

如要定義選單，請在專案的 res/menu/ 目錄，並使用以下程式碼建構選單元素：

<menu>: 定義一個 Menu，這是選單項目使用的容器。A 罩杯 <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>

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

選項選單 (例如圖 1 所示的選項選單) 包含與目前活動內容相關的動作和其他選項例如「搜尋」「撰寫電子郵件」和「設定」

這張圖片顯示 Google 試算表應用程式的應用程式列 — **圖 2.** Google 試算表應用程式。，包括動作溢位按鈕在內

如要在選項選單中宣告項目，請前往： Activity 子類別或 Fragment 子類別。如果您的活動和片段都宣告了選項選單，那麼這些項目就會在 UI 中合併顯示。系統會顯示活動項目，接著是各個片段的這些片段，按照片段的順序都會新增到活動中。如有需要，你可以使用每個屬性的 android:orderInCategory 屬性您需要移動 <item>。

若要指定活動的選項選單，請覆寫 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或使用者可以在當中直接對各項資源執行動作的其他檢視畫面集合項目。

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

在浮動內容選單中。選單會以浮動清單的形式顯示選單項目，類似於對話方塊。使用者進行觸控後保留可宣告結構定義支援的檢視畫面或前往 Google 試算表選單使用者一次可以對一個項目執行內容關聯操作。
在關聯動作模式中。這個模式是系統實作 ActionMode 會在網頁頂端顯示關聯動作列 (簡稱 CAB) 顯示影響所選項目的操作項目。何時處於這個模式有效，使用者可以一次對多個項目執行一項操作 (如果您但應用程式都支援這項功能

注意： 內容選單不支援項目捷徑和項目圖示。

建立浮動內容選單

如要提供浮動內容選單，請執行下列步驟：

註冊與內容選單相關聯的 View 撥號中 registerForContextMenu() 然後傳送 View。
如果您的活動使用 RecyclerView，而您想為每個活動個別設定項目來提供相同的內容選單，請為內容註冊所有項目方法是將 RecyclerView 傳遞至 registerForContextMenu()。

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

註冊的檢視畫面收到觸控和保留事件時，系統會呼叫您的 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，您指派給每個選單項目在 XML 中透過 android:id 屬性使用選單項目，如以 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 對例如將標題和子標題 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 的強制回應選單。會顯示在錨定標記下方看看是否有空間，或位於檢視畫面上方。這項功能非常實用包括：

為相關的動作提供溢位樣式選單例如 Gmail 的電子郵件標頭等特定內容，如圖 4 所示。
注意：這與內容選單不同。這通常適用於影響所選內容的動作。針對會影響所選內容的操作，請使用關聯動作模式或浮動式內容選單
提供指令語句的第二部分，例如標示有新增，以產生具有不同「Add」的彈出式選單只要設定成「自動重新啟動」和「在主機維護期間」選項即可
提供與 Spinner 不會保留永久選項

如果您以 XML 定義選單，以下是顯示彈出式選單：

利用其建構函式將 PopupMenu 例項化，此函式會採用目前使用的應用程式 Context和選單錨定位置的 View。
使用 MenuInflater 將選單資源加載至 Menu 物件由傳回 PopupMenu.getMenu()。
呼叫 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 並呼叫PopupMenu setOnMenuItemclickListener()。當使用者選取某個項目時，系統會呼叫 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()。

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

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

<?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 屬性元素，或是以 android:checkableBehavior 定義整個群組屬性加入 <group> 元素中。例如，這個選單群組可透過圓形按鈕勾選：

<?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, 做為應用程式或其他應用程式的活動當您瞭解您要使用的意圖，並透過特定選單項目來啟動該意圖您就能使用 startActivity() 適當的回呼方法，例如 onOptionsItemSelected() 回呼。

然而，如果您不確定使用者裝置是否含有系統處理意圖，然後新增會叫用該意圖的選單項目，可能會導致選單項目無法運作，因為意圖可能無法解析為活動。為此，Android 可讓您以動態方式將選單項目加入選單 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>

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