【Android】ActionBarでメニュー項目を表示・非表示に切り替える方法

ActionBarのメニュー項目を表示・非表示にする方法

このチュートリアルでは、AndroidのActionBar（アクションバー）上のメニュー項目を、ToggleButtonのオン／オフ操作に合わせて動的に表示・非表示する方法を解説します。

ポイントは、onCreateOptionsMenu()で生成されたMenuオブジェクトへの参照をフィールドに保持しておくことです。こうすることで、任意のタイミングでfindItem()により対象のMenuItemを取得し、setVisible()やsetEnabled()を呼び出して表示・有効状態を自由に切り替えられるようになります。

実装手順

ステップ1：新規プロジェクトの作成

Android Studioで新しいプロジェクトを作成します。メニューから「File」⇒「New Project」を選択し、必要な項目を入力してプロジェクトを生成してください。

ステップ2：レイアウトファイル（activity_main.xml）

res/layout/activity_main.xmlに以下のコードを追加します。ここでは、メニューの表示を切り替えるためのToggleButtonを1つ配置しています。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:gravity="center"
    tools:context=".MainActivity">

    <ToggleButton
        android:id="@+id/btnMenuItem"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />
</LinearLayout>

ステップ3：MainActivity.java

src/MainActivity.javaに以下のコードを追加します。onCreateOptionsMenu()内でMenuオブジェクトをフィールドに保存しておき、ToggleButtonのチェック状態に応じてシェアメニューの可視性・有効性を切り替えています。

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.view.Menu;
import android.view.MenuInflater;
import android.view.MenuItem;
import android.widget.CompoundButton;
import android.widget.ToggleButton;

public class MainActivity extends AppCompatActivity {
   ToggleButton button1;
   Menu myMenu;

   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
      button1 = findViewById(R.id.btnMenuItem);
      button1.setOnCheckedChangeListener(onCheckedChangeListener);
   }

   CompoundButton.OnCheckedChangeListener onCheckedChangeListener = new CompoundButton.OnCheckedChangeListener() {
      @Override
      public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
         if (myMenu != null) {
            if (buttonView == button1) {
               myMenu.findItem(R.id.menu_action_share).setVisible(isChecked);
               myMenu.findItem(R.id.menu_action_share).setEnabled(isChecked);
            }
         }
      }
   };

   public boolean onCreateOptionsMenu(Menu menu) {
      MenuInflater inflater = getMenuInflater();
      inflater.inflate(R.menu.menuitem, menu);
      myMenu = menu;
      MenuItem item = menu.findItem(R.id.menu_action_share);
      if (item != null) {
         item.setVisible(true);
      }
      return true;
   }
}

ステップ4：メニューリソースファイルの作成

resディレクトリを右クリックして「menu」フォルダを作成します。続けてmenuフォルダを右クリックし、メニューリソースファイル（menuitem.xml）を新規作成して、以下のコードを記述します。

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

    <item
        android:id="@+id/menu_action_share"
        android:icon="@drawable/ic_share_black_24dp"
        android:title="Share"
        app:showAsAction="ifRoom"/>
</menu>

ステップ5：AndroidManifest.xml

androidManifest.xmlに以下のコードを追加します。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="app.com.sample">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

アプリを実行してみる

それではアプリを実行してみましょう。実際のAndroid端末をパソコンに接続している前提で進めます。Android Studioからアプリを起動するには、プロジェクト内のアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックします。デバイス選択ダイアログで自分のモバイル端末を選択すると、端末に以下のような初期画面が表示されます。