Android TableLayoutでボタンを動的生成!Javaで均等配置する方法

この記事は約11分で読めます。

Androidアプリを開発していると、「画面にボタンを複数配置したい」「ボタンの数に応じて行を自動生成したい」「画面幅に合わせてボタンを均等に並べたい」といった場面があります。

このような場合に便利なのが、Androidの TableLayoutとTableRow です。

TableLayoutを利用すると、表形式でボタンを配置できます。また、JavaのコードからTableRowやButtonを動的に生成することで、ボタンの数に応じた柔軟なレイアウトを実現できます。

この記事では、Android StudioでJavaを使い、TableLayoutにボタンを動的に追加して均等幅で配置する方法を紹介します。

実際に使えるXMLとJavaのサンプルコードを掲載しているので、ぜひ参考にしてください。

この記事でわかること

  • TableLayoutとTableRowの基本的な使い方
  • Javaからボタンを動的に生成する方法
  • TableRowに複数のボタンを追加する方法
  • LayoutParamsのweightを使ってボタンを均等配置する方法
  • ボタンの数に応じて行を自動生成する方法

1. TableLayoutでボタンを動的に配置する

まずは、今回作成するレイアウトの仕組みを確認しましょう。

TableLayoutは、行と列を使ってViewを配置するためのAndroid標準のレイアウトです。

次のような階層で構成します。

text

TableLayout
 ├─ TableRow(1行目)
 │   ├─ Button
 │   ├─ Button
 │   └─ Button
 │
 ├─ TableRow(2行目)
 │   ├─ Button
 │   ├─ Button
 │   └─ Button
 │
 └─ TableRow(3行目)
     ├─ Button
     ├─ Button
     └─ Button

今回は、1行に3個のボタンを配置する例で説明します。

ポイントは、TableRowをJavaから追加し、その中にButtonを追加していくことです。

2. XMLでTableLayoutを定義する

最初に、ボタンを配置するためのTableLayoutをXMLで作成します。

レイアウトファイル(例:activity_main.xml)に以下のコードを記述してください。

xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <TableLayout
        android:id="@+id/TableLayout1"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_margin="10dp"
        android:stretchColumns="0,1,2" />

</LinearLayout>

XMLの設定ポイント

設定説明
layout_width親の横幅いっぱいに配置
layout_height内容に応じた高さに設定
layout_margin外側の余白を10dpに設定
stretchColumns指定した列を横方向に拡張

特に重要なのが、以下の設定です。

xml

android:stretchColumns="0,1,2"

これは、指定した列を横方向に拡張する設定です。

なお、後述するJavaコードではweightを使って幅を均等配分するため、そちらが均等配置の中心となります。

3. JavaでTableRowとButtonを動的に生成する

次に、JavaからTableLayoutにボタンを追加していきます。

3-1. TableLayoutを取得する

まず、XMLで定義したTableLayoutを取得します。

java

TableLayout tableLayout =
        findViewById(R.id.TableLayout1);

これでJavaからTableLayoutを操作できるようになります。

3-2. TableRowを追加する

TableLayoutの中にTableRowを追加します。

java

TableRow tableRow = new TableRow(this);

tableLayout.addView(tableRow);

TableRowが1行分の領域になります。

3-3. Buttonを追加する

TableRowにButtonを追加するには、addView()を使用します。

java

Button button = new Button(this);

button.setText("ボタン1");

tableRow.addView(button);

これで、TableLayoutにボタンを1つ追加できます。

複数のボタンを配置したい場合は、同じ処理を繰り返します。

4. ボタンを均等幅で配置する方法

ここが今回の重要なポイントです。

通常の方法でButtonを追加すると、ボタンの文字数などによって幅が異なる場合があります。

そこで、TableRow.LayoutParamsのweightを使用します。

java

TableRow.LayoutParams buttonLayoutParams =
        new TableRow.LayoutParams(
                0,
                TableRow.LayoutParams.WRAP_CONTENT,
                1
        );

button.setLayoutParams(buttonLayoutParams);

weightの設定について

今回の設定で重要なのは、以下の部分です。

java

new TableRow.LayoutParams(
        0,
        TableRow.LayoutParams.WRAP_CONTENT,
        1
);

それぞれの意味は次のとおりです。

設定値意味
0ボタンの基本幅を0にする
WRAP_CONTENT高さを内容に合わせる
1横幅の配分比率を1にする

widthを0にしてweightを1にすることで、余った横幅をweightに応じて配分できます。

例えば、1行に3個のボタンを配置し、それぞれのweightを1にすると、次のようになります。

text

┌────────┬────────┬────────┐
│  ボタン1   │  ボタン2   │  ボタン3   │
└────────┴────────┴────────┘
     1        1         1

3つのボタンに均等に横幅が割り当てられます。

5. 実際に使えるJavaサンプルコード

ここまでの内容をまとめて、ボタンを動的に生成するサンプルコードを紹介します。

今回は、ボタンの文字列をListに格納し、3個ずつTableRowに追加する方法です。

java

public class MainActivity extends AppCompatActivity {

    private TableLayout tableLayout;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        tableLayout = findViewById(R.id.TableLayout1);

        List<String> buttonList = Arrays.asList(
                "ボタン1",
                "ボタン2",
                "ボタン3",
                "ボタン4",
                "ボタン5",
                "ボタン6",
                "ボタン7",
                "ボタン8",
                "ボタン9"
        );

        initTableLayout(buttonList);
    }

    private void initTableLayout(List<String> buttonList) {

        int columnCount = 3;

        tableLayout.removeAllViews();

        TableRow tableRow = null;

        for (int i = 0; i < buttonList.size(); i++) {

            if (i % columnCount == 0) {

                tableRow = new TableRow(this);

                tableLayout.addView(tableRow);
            }

            Button button = new Button(this);

            button.setText(buttonList.get(i));
            button.setTextSize(18);

            TableRow.LayoutParams params =
                    new TableRow.LayoutParams(
                            0,
                            TableRow.LayoutParams.WRAP_CONTENT,
                            1
                    );

            button.setLayoutParams(params);

            tableRow.addView(button);
        }
    }
}

※このサンプルでは、AndroidXのAppCompatActivityを使用しています。必要なListやArraysのimportも追加してください。

サンプルコードのポイント

① 1行に配置するボタンの数を指定

java

int columnCount = 3;

この数値を変更することで、1行あたりのボタン数を変更できます。

② 行を自動生成する

java

if (i % columnCount == 0) {

    tableRow = new TableRow(this);

    tableLayout.addView(tableRow);
}

ボタンの番号が列数で割り切れる場合、新しいTableRowを生成します。

これにより、ボタンの数に応じて行が自動的に追加されます。

③ ボタンを均等幅にする

java

TableRow.LayoutParams params =
        new TableRow.LayoutParams(0,
                TableRow.LayoutParams.WRAP_CONTENT, 1);

各ボタンに同じweightを設定することで、横幅を均等に配分します。

この方法なら、ボタンの数が増減しても、基本的に同じ処理で対応できます。

6. 実装時の注意点

ボタンの数が列数で割り切れない場合

例えば、1行に3個のボタンを配置する設定で、ボタンが7個ある場合は次のようになります。

text

1行目:ボタン1・ボタン2・ボタン3
2行目:ボタン4・ボタン5・ボタン6
3行目:ボタン7

最後の行にはボタンが1個だけ配置されます。

この場合、残りの空きスペースをそのボタンが使うため、最後のボタンは横幅いっぱいに広がります。

最後の行も3列に固定したい場合は、不足分に空のViewを追加する方法があります。

ボタンの高さを統一したい場合

ボタンの高さを統一するには、LayoutParamsの高さを固定値に変更する方法があります。

例えば、60dp相当の高さにしたい場合は、次のように指定します。

java

int height = (int) (60 *
        getResources().getDisplayMetrics().density);

TableRow.LayoutParams params =
        new TableRow.LayoutParams(0, height, 1);

画面サイズや文字サイズに応じて、見やすい高さに調整してください。

7. まとめ

今回は、AndroidのTableLayoutを使って、Javaからボタンを動的に生成し、均等幅で配置する方法を紹介しました。

重要なポイントは次の3つです。

  1. TableLayoutにTableRowを追加する
  2. TableRowにButtonを追加する
  3. TableRow.LayoutParamsのweightを設定する

特に、以下の設定がボタンを均等幅にするための重要なポイントです。

java

new TableRow.LayoutParams(
        0,
        TableRow.LayoutParams.WRAP_CONTENT,
        1
);

この方法を使えば、ボタンの数や配置する列数に応じて、柔軟にレイアウトを生成できます。

Androidアプリでボタンを動的に追加したい場合は、ぜひ活用してみてください。

よくある質問(FAQ)

Q1. TableLayoutでボタンを均等幅にするには?

TableRow.LayoutParamsのwidthを0にし、weightを1に設定します。同じweightを設定したボタン同士で横幅が均等に配分されます。

Q2. TableLayoutにボタンを動的に追加するには?

TableRowを生成してTableLayout.addView()で追加し、そのTableRowにButtonをaddView()で追加します。

Q3. 1行に配置するボタンの数を変更できますか?

はい。サンプルコードのcolumnCountを変更することで、1行あたりのボタン数を変更できます。

Q4. ボタンの数が増えても自動的に行を追加できますか?

はい。ボタンを追加する際に、列数に応じてTableRowを生成する処理を入れることで自動化できます。

Q5. TableLayout以外でもボタンを均等配置できますか?

はい。LinearLayoutやGridLayoutなどでも実現できます。複雑なグリッド配置の場合はGridLayoutも選択肢になります。


関連ページ

Androidのボタンデザイン集|shape Drawableで角丸・楕円・枠線を作る方法
AndroidアプリのボタンをXMLのshape Drawableでデザインする方法を解説。角丸・楕円・枠線・グラデーション・押下時の色変更など、コピペで使えるサンプルコードとJava・Kotlinでの実装方法を紹介します。
タイトルとURLをコピーしました