【Kotlin入門】AndroidでImageViewのマージンをコードから動的に設定する方法

このチュートリアルでは、Kotlinを使用してAndroidアプリのImageViewにマージン（外側の余白）をプログラム的に設定する方法を、ステップごとにわかりやすく解説します。レイアウトXMLだけでなく、コードから動的に余白を変更したい場合に役立つテクニックです。

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

Android Studioを起動し、「File」→「New Project」を選択して新しいプロジェクトを作成します。必要な項目（プロジェクト名、パッケージ名、保存先など）をすべて入力してください。言語は「Kotlin」を選択します。

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

res/layout/activity_main.xml に以下のコードを追加します。ここではRelativeLayoutの中にImageViewを配置しています。

<?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：MainActivity.ktでマージンを設定する

src/MainActivity.kt に以下のコードを記述します。ポイントは、imageView.layoutParams を RelativeLayout.LayoutParams として取得し、setMargins() メソッドで余白を指定した後、再度 layoutParams を代入し直すことです。

import android.os.Bundle
import android.widget.ImageView
import android.widget.RelativeLayout
import androidx.appcompat.app.AppCompatActivity

class MainActivity : AppCompatActivity() {

    lateinit var imageView: ImageView

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        title = "KotlinApp"

        imageView = findViewById(R.id.imageView)

        val layoutParams = imageView.layoutParams as RelativeLayout.LayoutParams
        layoutParams.setMargins(100, 100, 100, 100)
        imageView.layoutParams = layoutParams
    }
}

setMargins() の引数について

setMargins(left, top, right, bottom) の順に、左・上・右・下の余白をピクセル（px）単位で指定します。上記の例では全方向に100pxのマージンが設定されます。なお、dp（密度非依存ピクセル）で指定したい場合は、画面密度を掛けてpxに変換してから渡すと、端末ごとの見た目の差を抑えられます。

ステップ4：AndroidManifest.xmlの確認

androidManifest.xml は以下のようになっていることを確認してください。

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

    <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（緑色の再生アイコン）」をクリックします。表示された候補から接続したモバイルデバイスを選択すると、実機上でアプリが起動します。

正常に動作していれば、ImageViewの周囲に均等な余白（マージン）が設けられた画面が表示されるはずです。setMargins() の数値を変更して、余白の変化を確認してみてください。