AndroidのラジオボタンにOnClickListenerを設定する方法【サンプルコード付きで解説】

はじめに

このチュートリアルでは、Androidアプリのラジオボタン（RadioButton）にクリックイベントを設定する方法を解説します。レイアウトXMLのandroid:onClick属性を利用すれば、JavaコードでsetOnClickListener()を明示的に呼び出すことなく、クリック時の処理をシンプルに実装できます。

今回は「ドライブしたい車を選ぶ」というサンプルアプリを通じて、実装手順をステップごとに見ていきましょう。

手順1：新規プロジェクトを作成する

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

手順2：レイアウトファイル（activity_main.xml）を編集する

res/layout/activity_main.xml に以下のコードを記述します。

ポイントは、各RadioButtonに指定したandroid:onClick属性です。ここで指定したメソッド名が、次の手順でActivityに定義するクリックハンドラーメソッドと自動的に紐付けられます。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout 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:gravity="center"
    tools:context=".MainActivity">

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_above="@id/radioGroup"
        android:layout_marginBottom="20sp"
        android:layout_centerInParent="true"
        android:textSize="16sp"
        android:textStyle="bold|italic"
        android:text="Select your favourite to drive..."/>

    <RadioGroup
        android:id="@+id/radioGroup"
        android:layout_centerInParent="true"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:orientation="vertical">

        <RadioButton
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="BMW"
            android:onClick="onClickedBMW"/>

        <RadioButton
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="NISSAN GTR"
            android:onClick="onClickedNissan"/>

        <RadioButton
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Lamborghini"
            android:onClick="onClickedLamborghini"/>

    </RadioGroup>
</RelativeLayout>

手順3：MainActivity.java を実装する

src/MainActivity.java に以下のコードを追加します。

XMLのandroid:onClickで指定した名前（onClickedBMW／onClickedNissan／onClickedLamborghini）と同じpublicメソッドを定義し、引数としてViewを受け取ります。メソッド内ではToastを表示し、選択された車をユーザーに通知しています。

import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }

    public void onClickedBMW(View view) {
        Toast.makeText(this, "BMW is selected for a drive!", Toast.LENGTH_SHORT).show();
    }

    public void onClickedNissan(View view) {
        Toast.makeText(this, "Nissan GTR is selected for a drive!", Toast.LENGTH_SHORT).show();
    }

    public void onClickedLamborghini(View view) {
        Toast.makeText(this, "Lamborghini is selected for a drive!", Toast.LENGTH_SHORT).show();
    }
}

補足： 最近のAndroid Studioのプロジェクトテンプレートでは、親クラスがandroidx.appcompat.app.AppCompatActivityになっています。既存のimport文をそのまま利用すれば問題なく動作します。

手順4：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端末をPCに接続している前提で説明を進めます。Android Studioでプロジェクトのアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックしてください。デバイスを選択すると、スマートフォンの画面に以下のように表示されます。

まとめ

ラジオボタンのクリックイベント設定には、主に2つの方法があります。

• XMLのandroid:onClick属性を使う方法： レイアウト側でメソッド名を指定できるため、コードが簡潔になる
• setOnClickListener()を使う方法： Java／Kotlinコード内でリスナーを登録する、より柔軟な標準的な方法

また、RadioGroup単位で選択状態の変化を監視したい場合はsetOnCheckedChangeListener()を活用すると便利です。用途に合わせて使い分けてみてください。