【Android開発】プログラムから背景ドローアブル（Drawable）を動的に設定する方法

本記事では、AndroidアプリにおいてJavaコードから背景ドローアブル（Drawable）を動的に設定する方法を、実際のサンプルコードとともにステップ形式で解説します。ボタンをタップしたタイミングでレイアウトの背景画像を切り替えるシンプルなデモを通じて、setBackgroundResource()メソッドの基本的な使い方をマスターしましょう。

全体の流れ

今回作成するのは、画面上のボタンを押すとRelativeLayoutの背景画像が変更されるという簡単なアプリです。実装手順は以下の4ステップです。

1. Android Studioで新規プロジェクトを作成する
2. レイアウトファイル（activity_main.xml）を作成する
3. MainActivity.javaに処理を記述する
4. AndroidManifest.xmlを確認する

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

まず、Android Studioを起動し、メニューから「File」→「New Project」を選択します。必要な情報（プロジェクト名、パッケージ名、保存先など）を入力して、新しいプロジェクトを作成してください。

ステップ2：レイアウトファイルの編集

次に、res/layout/activity_main.xmlに以下のコードを追加します。ここでは、背景を変更する対象となるRelativeLayoutと、クリックイベントを発生させるためのButtonを配置しています。

<?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:id="@+id/rl"
    tools:context=".MainActivity">
    <Button
        android:text="Set Drawable"
        android:id="@+id/btnSetDrawable"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerHorizontal="true"
        android:layout_marginTop="10dp"/>
</RelativeLayout>

ポイントは、RelativeLayoutにandroid:id="@+id/rl"を指定している点です。このIDを使って、Javaコード側からビューを参照できるようになります。

ステップ3：MainActivity.javaの実装

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

import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.RelativeLayout;
public class MainActivity extends AppCompatActivity {
    Button button;
    RelativeLayout relativeLayout;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        relativeLayout = findViewById(R.id.rl);
        button = findViewById(R.id.btnSetDrawable);
        button.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                relativeLayout.setBackgroundResource(R.drawable.image);
            }  
        });
    }
}

コードのポイント

背景を設定しているのは、onClick()内の以下の1行です。

relativeLayout.setBackgroundResource(R.drawable.image);

setBackgroundResource()メソッドは、引数に渡したリソースID（ここではR.drawable.image）の画像を、そのビューの背景として設定します。res/drawableフォルダ内にあらかじめimage.pngなどの画像ファイルを配置しておく必要があるので注意してください。

なお、既存の背景リソースではなくDrawableオブジェクトや色を直接指定したい場合は、setBackground(Drawable)やsetBackgroundColor(int)といったメソッドも利用できます。

ステップ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スマートフォンがパソコンにUSB接続されているものとします。

Android Studioからアプリを起動するには、プロジェクト内のアクティビティファイルを開き、ツールバーにある「Run」アイコンをクリックします。表示された候補の中から接続済みのモバイルデバイスを選択してください。

アプリが起動すると、まずは何も背景がないデフォルトの画面が表示されます。

ここで「Set Drawable」ボタンをタップすると、setBackgroundResource()が呼び出され、画面全体の背景が指定した画像に切り替わります。

まとめ

今回は、Androidでプログラムから背景ドローアブルを設定する基本手法として、setBackgroundResource()メソッドの使い方を紹介しました。ボタンのクリックイベントと組み合わせることで、ユーザーの操作に応じて動的に見た目を変えるUIが簡単に実装できます。テーマ切り替え機能や画像ギャラリーなど、さまざまな場面で応用できるテクニックなので、ぜひ覚えておきましょう。