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つです。
- TableLayoutにTableRowを追加する
- TableRowにButtonを追加する
- 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も選択肢になります。
関連ページ



