AndroidのRadioGroup（ラジオグループ）とは？基本的な使い方をわかりやすく解説

AndroidにおけるRadioGroupとは

Androidアプリ開発において、RadioGroup（ラジオグループ）は、複数のRadioButton（ラジオボタン）をひとまとめに管理するためのウィジェットです。RadioGroup内に配置されたラジオボタンは、同時に1つしか選択できないという特性を持ちます。ユーザーは提示された選択肢の中から1つの項目を選び、必要に応じて別の項目へ切り替えることができます。

本記事では、RadioGroupを使用して選択された項目のテキストを取得し、Toastで表示するシンプルなサンプルアプリの作成方法を、ステップごとに解説します。

実装手順

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

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

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

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

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:app="https://schemas.android.com/apk/res-auto"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:gravity="center"
    android:orientation="vertical"
    tools:context=".MainActivity">
    <TextView
        android:id="@+id/result"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Select your favourite subject"
        android:textSize="20sp"
        android:padding="10dp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent" />
    <RadioGroup
        android:id="@+id/radioGroup"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:padding="10dp">
        <RadioButton
            android:id="@+id/adroid"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Android"/>
        <RadioButton
            android:id="@+id/java"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="java"/>
        <RadioButton
            android:id="@+id/cpp"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="CPP"/>
        <RadioButton
            android:id="@+id/clan"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="C Programming"/>
    </RadioGroup>
    <Button
        android:id="@+id/buton"
        android:text="ok"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />
</LinearLayout>

このレイアウトには、4つのラジオボタン（Android / Java / CPP / C Programming）を格納したRadioGroupと、案内文を表示するTextView、確認用のButtonが含まれています。ユーザーがボタンをクリックすると、チェックされているラジオボタンのテキストを取得できるようになっています。

ステップ3：MainActivity.javaの編集

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

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

public class MainActivity extends AppCompatActivity {
    RadioButton radioButton;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        final Button button=findViewById(R.id.buton);
        final RadioGroup radioGroup=findViewById(R.id.radioGroup);
        button.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                int clickedRadioButton=radioGroup.getCheckedRadioButtonId();
                radioButton=findViewById(clickedRadioButton);
                if(clickedRadioButton ==-1){
                    button.setError("Error");
                } else {
                    button.setError(null);
                    Toast.makeText(MainActivity.this,radioButton.getText(),Toast.LENGTH_LONG).show();
                }
            }
        });
    }
}

ポイントは getCheckedRadioButtonId() メソッドです。このメソッドは現在選択されているラジオボタンのIDを返しますが、何も選択されていない場合は -1 を返します。サンプルでは、未選択の場合にボタンへエラーを表示し、選択済みの場合はそのテキストをToastで通知する処理を行っています。

ステップ4：アプリの実行と動作確認

manifest.xml を変更する必要はありません。それではアプリを実行してみましょう。実機のAndroidデバイスをパソコンに接続しているものとします。Android Studioからアプリを実行するには、プロジェクト内のアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックします。接続したモバイルデバイスを選択すると、端末に以下のような初期画面が表示されます。

任意の科目を選択します。ここでは例として「java」を選択した状態を示します。

続いて「ok」ボタンをクリックすると、RadioGroup内で選択されたラジオボタンのテキストを取得できます。

上記の実行結果のように、「ok」ボタンを押すと、選択されたラジオボタンのテキストがToastとして画面に表示されます。

まとめ

RadioGroupを使うことで、複数の選択肢から1つだけを選ばせるUIを簡単に実装できます。アンケートフォームや設定画面など、排他的な選択が必要な場面でぜひ活用してください。