【Android】コードからImageViewのマージン（余白）を設定する方法

この記事では、Androidアプリ開発においてJavaコードを使ってImageViewのマージン（余白）を動的に設定する方法を解説します。レイアウトXMLではなくプログラム側で余白を制御したい場合に役立つテクニックです。

全体の流れ

今回のサンプルでは、RelativeLayoutの中に配置したImageViewに対して、setMargins()メソッドを使って上下左右すべてに余白を設定します。

ステップ1：新規プロジェクトを作成する

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

ステップ2：activity_main.xmlにコードを追加する

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

<?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"
    tools:context=".MainActivity">

    <ImageView
        android:id="@+id/imageView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:background="@drawable/image"/>

</RelativeLayout>

ステップ3：画像ファイルを配置する

表示用の画像ファイルをコピーし、res/drawableフォルダ内に貼り付けてください。ここではファイル名を「image」としています。

ステップ4：MainActivity.javaにコードを追加する

続いて、src/MainActivity.javaに以下のコードを記述します。この部分がマージン設定の核心です。

import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.ImageView;
import android.widget.RelativeLayout;

public class MainActivity extends AppCompatActivity {

    ImageView imageView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        imageView = findViewById(R.id.imageView);
        final RelativeLayout.LayoutParams layoutparams = (RelativeLayout.LayoutParams)imageView.getLayoutParams();
        layoutparams.setMargins(100,100,100,100);
        imageView.setLayoutParams(layoutparams);
    }
}

ポイント：setMargins()の引数について

setMargins()メソッドは、左・上・右・下の順に4つの引数を受け取ります。上記の例ではすべて「100」を指定しているため、画像の周囲に均等な余白ができます。なお、指定する数値の単位はピクセル（px）です。画面密度によって見た目が変わるため、実務ではdp単位へ変換してから設定するのが望ましいでしょう。

また、親レイアウトがLinearLayoutの場合はLinearLayout.LayoutParamsにキャストする必要がある点にも注意してください。

ステップ5：androidManifest.xmlを確認する

androidManifest.xmlには以下のようにMainActivityを登録します。通常、プロジェクト作成時に自動生成されています。

<?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）アイコンをクリックします。表示された選択肢から自分のモバイルデバイスを選ぶと、端末の画面に以下のような結果が表示されます。

まとめ

ImageViewのマージンをコードで設定するには、getLayoutParams()で現在のLayoutParamsを取得し、setMargins()で値を変更した後、setLayoutParams()で再設定する、という3ステップが基本になります。動的にUIを調整したい場面でぜひ活用してください。