【Menu】Activityにメニューを表示させる方法

やりたいこと

Activity上にメニューを配置、および押されたときの動作を実装したい。

手順

menuを作成する

表示したいmenuをXMLファイルで作成します。
各メニューはitemタグで表します。

ここでは例として、追加ボタン・ソートボタン・設定ボタンを表示してみましょう。

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto">

    <item
        android:id="@+id/menu_add"
        android:icon="@drawable/ic_add"
        android:title="追加"
        app:showAsAction="always" />

    <item
        android:id="@+id/menu_sort"
        android:icon="@drawable/ic_sort"
        android:title="ソート"
        app:showAsAction="always" />

    <item
        android:id="@+id/menu_setting"
        android:icon="@drawable/ic_setting"
        android:title="設定"
        app:showAsAction="always" />
</menu>

ActivityでonCreateOptionsMenuをオーバーライドする

メニューを表示したいActivityでonCreateOptionsMenuをオーバーライドします。
inflateする際の第1引数に、先ほど作成したmenuを渡してあげましょう。

override fun onCreateOptionsMenu(menu: Menu?): Boolean {
    menuInflater.inflate(R.menu.menu_main_activity, menu)
    return super.onCreateOptionsMenu(menu)
}

ActivityでonOptionsItemSelectedをオーバーライドする

最後にメニューをタップされたときの動作を実装するため、onOptionsItemSelectedをオーバーライドします。
引数で押されたMenuItemが渡ってくるので、itemIdでどのメニューが押されたか判定しましょう。

override fun onOptionsItemSelected(item: MenuItem?): Boolean {
    when (item?.itemId) {
        R.id.menu_add -> {
            Toast.makeText(this, "追加ボタンが押されました", Toast.LENGTH_SHORT).show()
            return false
        }
        R.id.menu_sort -> {
            Toast.makeText(this, "ソートボタンが押されました", Toast.LENGTH_SHORT).show()
            return false
        }
        R.id.menu_setting -> {
            Toast.makeText(this, "設定ボタンが押されました", Toast.LENGTH_SHORT).show()
            return false
        }
    }
    return true
}

ソースコード

MainActivity.kt

package katapiproject.practice

import android.os.Bundle
import android.support.v7.app.AppCompatActivity
import android.view.Menu
import android.view.MenuItem
import android.widget.Toast

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
    }

    override fun onCreateOptionsMenu(menu: Menu?): Boolean {
        menuInflater.inflate(R.menu.menu_main_activity, menu)
        return super.onCreateOptionsMenu(menu)
    }

    override fun onOptionsItemSelected(item: MenuItem?): Boolean {
        when (item?.itemId) {
            R.id.menu_add -> {
                Toast.makeText(this, "追加ボタンが押されました", Toast.LENGTH_SHORT).show()
                return false
            }
            R.id.menu_sort -> {
                Toast.makeText(this, "ソートボタンが押されました", Toast.LENGTH_SHORT).show()
                return false
            }
            R.id.menu_setting -> {
                Toast.makeText(this, "設定ボタンが押されました", Toast.LENGTH_SHORT).show()
                return false
            }
        }
        return true
    }

}

menu_main_activity.xml

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto">

    <item
        android:id="@+id/menu_add"
        android:icon="@drawable/ic_add"
        android:title="追加"
        app:showAsAction="always" />

    <item
        android:id="@+id/menu_sort"
        android:icon="@drawable/ic_sort"
        android:title="ソート"
        app:showAsAction="always" />

    <item
        android:id="@+id/menu_setting"
        android:icon="@drawable/ic_setting"
        android:title="設定"
        app:showAsAction="always" />
</menu>