java.awt
クラス GridLayout

java.lang.Object
  |
  +--java.awt.GridLayout

すべての実装インタフェース:

LayoutManager, Serializable

public class GridLayout

extends Object

implements LayoutManager, Serializable

GridLayout クラスは、矩形グリッドにコンテナのコンポーネントを配置するレイアウトマネージャです。コンテナはサイズが等しい矩形に分割され、矩形ごとに 1 つのコンポーネントが配置されます。たとえば、次の例は 6 つのボタンを 3 行 2 列に配置するアプレットを示します。

 import java.awt.*;
 import java.applet.Applet;
 public class ButtonGrid extends Applet {
     public void init() {
         setLayout(new GridLayout(3,2));
         add(new Button("1"));
         add(new Button("2"));
         add(new Button("3"));
         add(new Button("4"));
         add(new Button("5"));
         add(new Button("6"));
     }
 }
 

コンテナの ComponentOrientation プロパティが水平方向に左から右の場合、上記の例は図 1 に示すような出力を生成します。コンテナの ComponentOrientation プロパティが水平方向に右から左の場合、上記の例は図 2 に示すような出力を生成します。

図 1: 水平方向に左から右	図 2: 水平方向に右から左

行数と列数のどちらもゼロ以外の値に設定されている場合、コンストラクタによって、または setRows メソッドおよび setColumns メソッドによって、指定された列数は無視されます。代わりに、指定された行数およびレイアウトのコンポーネントの総数から、列数が決定されます。したがって、たとえば、3 行と 2 列が指定されていて 9 つのコンポーネントをレイアウトに追加する場合、コンポーネントは 3 列の 3 行に表示されます。列数の指定がレイアウトに影響するのは、行数がゼロに設定された場合だけです。

導入されたバージョン:

JDK1.0

関連項目:

直列化された形式

コンストラクタの概要

GridLayout()
1 行中にコンポーネントあたり 1 つの列を持つデフォルト指定でグリッドレイアウトを作成します。

GridLayout(int rows, int cols)
指定された数の行と列を持つグリッドレイアウトを作成します。

GridLayout(int rows, int cols, int hgap, int vgap)
指定された数の行と列を持つグリッドレイアウトを作成します。

メソッドの概要

void	addLayoutComponent(String name, Component comp) 指定された名前で、指定されたコンポーネントをレイアウトに追加します。
int	getColumns() このレイアウト内の列数を返します。
int	getHgap() コンポーネント間の水平方向の間隔を返します。
int	getRows() このレイアウト内の行数を返します。
int	getVgap() コンポーネント間の垂直方向の間隔を返します。
void	layoutContainer(Container parent) このレイアウトを使って、指定されたコンテナを配置します。
Dimension	minimumLayoutSize(Container parent) このグリッドレイアウトを使って、コンテナ引数の最小サイズを指定します。
Dimension	preferredLayoutSize(Container parent) このグリッドレイアウトを使って、コンテナ引数の推奨サイズを指定します。
void	removeLayoutComponent(Component comp) 指定されたコンポーネントをレイアウトから削除します。
void	setColumns(int cols) このレイアウトの列数を、指定された値に設定します。
void	setHgap(int hgap) コンポーネント間の水平方向の間隔を、指定された値に設定します。
void	setRows(int rows) このレイアウト内の行数を、指定された値に設定します。
void	setVgap(int vgap) コンポーネント間の垂直方向の間隔を、指定された値に設定します。
String	toString() このグリッドレイアウトの値の文字列表現を返します。

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

GridLayout

public GridLayout()

1 行中にコンポーネントあたり 1 つの列を持つデフォルト指定でグリッドレイアウトを作成します。

導入されたバージョン:

JDK1.1

GridLayout

public GridLayout(int rows,
                  int cols)

指定された数の行と列を持つグリッドレイアウトを作成します。レイアウト内のコンポーネントはすべて、等しいサイズに指定されます。

rows と cols のどちらか 1 つはゼロでもかまいません。ゼロの場合、オブジェクトをいくつでも 1 行または 1 列に配置できることを意味します。

パラメータ:

rows - 行数。値ゼロは任意の行数を意味する

cols - 列数。値ゼロは任意の列数を意味する

GridLayout

public GridLayout(int rows,
                  int cols,
                  int hgap,
                  int vgap)

指定された数の行と列を持つグリッドレイアウトを作成します。レイアウト内のコンポーネントはすべて、等しいサイズに指定されます。

さらに、水平方向と垂直方向の間隔が指定された値に設定されます。水平方向の間隔は、左端および右端と、列間に挿入されます。垂直方向の間隔は、上端および下端と、行間に挿入されます。

rows と cols のどちらか 1 つはゼロでもかまいません。ゼロの場合、オブジェクトをいくつでも 1 行または 1 列に配置できることを意味します。

すべての GridLayout コンストラクタはこのフレームに従います。

パラメータ:

rows - 行数。値ゼロは任意の行数を意味する

cols - 列数。値ゼロは任意の列数を意味する

hgap - 水平方向の間隔

vgap - 垂直方向の間隔

例外:

IllegalArgumentException - rows と cols の値をどちらともゼロに設定した場合

メソッドの詳細

getRows

public int getRows()

このレイアウト内の行数を返します。

戻り値:

このレイアウト内の行数

導入されたバージョン:

JDK1.1

setRows

public void setRows(int rows)

このレイアウト内の行数を、指定された値に設定します。

パラメータ:

rows - このレイアウト内の行数

例外:

IllegalArgumentException - rows と cols の値をどちらともゼロに設定した場合

導入されたバージョン:

JDK1.1

getColumns

public int getColumns()

このレイアウト内の列数を返します。

戻り値:

このレイアウト内の列数

導入されたバージョン:

JDK1.1

setColumns

public void setColumns(int cols)

このレイアウトの列数を、指定された値に設定します。コンストラクタまたは setRows メソッドによって指定された行の数がゼロでない場合は、列数の設定はレイアウトに影響しません。その場合、レイアウトに表示される列数は、コンポーネントの総数および指定された行の数によって決定されます。

パラメータ:

cols - このレイアウト内の列数

例外:

IllegalArgumentException - rows と cols の値をどちらともゼロに設定した場合

導入されたバージョン:

JDK1.1

getHgap

public int getHgap()

コンポーネント間の水平方向の間隔を返します。

戻り値:

コンポーネント間の水平方向の間隔

導入されたバージョン:

JDK1.1

setHgap

public void setHgap(int hgap)

コンポーネント間の水平方向の間隔を、指定された値に設定します。

パラメータ:

hgap - コンポーネント間の水平方向の間隔

導入されたバージョン:

JDK1.1

getVgap

public int getVgap()

コンポーネント間の垂直方向の間隔を返します。

戻り値:

コンポーネント間の垂直方向の間隔

導入されたバージョン:

JDK1.1

setVgap

public void setVgap(int vgap)

コンポーネント間の垂直方向の間隔を、指定された値に設定します。

パラメータ:

vgap - コンポーネント間の垂直方向の間隔

導入されたバージョン:

JDK1.1

addLayoutComponent

public void addLayoutComponent(String name,
                               Component comp)

指定された名前で、指定されたコンポーネントをレイアウトに追加します。

定義:

インタフェース LayoutManager 内の addLayoutComponent

パラメータ:

name - コンポーネントの名前

comp - 追加されるコンポーネント

removeLayoutComponent

public void removeLayoutComponent(Component comp)

指定されたコンポーネントをレイアウトから削除します。

定義:

インタフェース LayoutManager 内の removeLayoutComponent

パラメータ:

comp - 削除されるコンポーネント

preferredLayoutSize

public Dimension preferredLayoutSize(Container parent)

このグリッドレイアウトを使って、コンテナ引数の推奨サイズを指定します。

グリッドレイアウトの推奨幅は、コンテナ内の幅のどれかを列数倍にしたものに、水平パディングを列数プラス 1 倍したものを足し、さらにターゲットコンテナの右と左のインセットを足した最大幅になります。

グリッドレイアウトの推奨高さは、コンテナ内の高さのどれかを行数倍にしたものに、垂直パディングを行数プラス 1 倍したものを足し、さらにターゲットコンテナの上と下のインセットを足した最大の高さになります。

定義:

インタフェース LayoutManager 内の preferredLayoutSize

パラメータ:

parent - 配置されるコンテナ

戻り値:

指定されたコンテナのサブコンポーネントを配置する望ましい寸法

関連項目:

minimumLayoutSize(java.awt.Container), Container.getPreferredSize()

minimumLayoutSize

public Dimension minimumLayoutSize(Container parent)

このグリッドレイアウトを使って、コンテナ引数の最小サイズを指定します。

グリッドレイアウトの最小幅は、コンテナ内の幅のどれかを列数倍にしたものに、水平パディングを列数プラス 1 倍したものを足し、さらにターゲットコンテナの右と左のインセットを足したものの最小幅のうち最大のものになります。

グリッドレイアウトの最小の高さは、コンテナ内の高さのどれかを行数倍にしたものに、垂直パディングを行数プラス 1 倍したものを足し、さらにターゲットコンテナの上と下のインセットを足したものの最小の高さのうち最大のものになります。

定義:

インタフェース LayoutManager 内の minimumLayoutSize

パラメータ:

parent - 配置されるコンポーネント

戻り値:

指定されたコンテナのサブコンポーネントを配置するために必要な最小の寸法

関連項目:

preferredLayoutSize(java.awt.Container), Container.doLayout()

layoutContainer

public void layoutContainer(Container parent)

このレイアウトを使って、指定されたコンテナを配置します。

このメソッドは、GridLayout オブジェクトの制約を満たすために、指定されたターゲットコンテナ内のコンポーネントの形状を再成形します。

グリッドレイアウトマネージャは、個別のコンポーネントのサイズを指定するために、コンテナ内の空き領域をレイアウトの行数と列数に従って等分します。コンテナの空き領域は、コンテナのサイズから、任意のインセットおよび指定された任意の水平または垂直の間隔を引いたものに等しくなります。グリッドレイアウト内のコンポーネントはすべて、同じサイズに設定されます。

定義:

インタフェース LayoutManager 内の layoutContainer

パラメータ:

parent - 配置されるコンテナ

関連項目:

Container, Container.doLayout()

toString

public String toString()

このグリッドレイアウトの値の文字列表現を返します。

オーバーライド:

クラス Object 内の toString

戻り値:

このグリッドレイアウトの文字列表現