GridLayout (Java Platform SE 7)

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 つだけを 0 にすることができます。つまり、行または列に任意の数のオブジェクトを配置できます。
    
    パラメータ:
    rows - 行数。値ゼロは任意の数の行を意味する。
    cols - 列数。値ゼロは任意の数の列を意味する。
  - GridLayout
```
public GridLayout(int rows,
          int cols,
          int hgap,
          int vgap)
```
    指定された数の行と列を持つグリッドレイアウトを作成します。レイアウト内のコンポーネントはすべて、等しいサイズに指定されます。
    さらに、水平方向と垂直方向の間隔が指定された値に設定されます。水平方向の間隔は列間に挿入されます。垂直方向の間隔は行間に挿入されます。
    rows と cols のどちらか 1 つだけを 0 にすることができます。つまり、行または列に任意の数のオブジェクトを配置できます。
    すべての GridLayout コンストラクタはこのコンストラクタに従います。
    
    パラメータ:
    rows - 行数。値ゼロは任意の数の行を意味する
    cols - 列数。値ゼロは任意の数の列を意味する
    hgap - 水平方向の間隔
    vgap - 垂直方向の間隔
    
    例外:
    
    IllegalArgumentException - rows と cols の両方の値が 0 に設定されている場合
- メソッドの詳細
  - getRows
```
public int getRows()
```
    このレイアウト内の行数を返します。
    
    戻り値:
    このレイアウト内の行数
    導入されたバージョン:
    
    JDK1.1
  - setRows
```
public void setRows(int rows)
```
    このレイアウト内の行数を、指定された値に設定します。
    
    パラメータ:
    rows - このレイアウト内の行数
    
    例外:
    
    IllegalArgumentException - rows と cols の両方の値が 0 に設定されている場合
    導入されたバージョン:
    
    JDK1.1
  - getColumns
```
public int getColumns()
```
    このレイアウト内の列数を返します。
    
    戻り値:
    このレイアウト内の列数
    導入されたバージョン:
    
    JDK1.1
  - setColumns
```
public void setColumns(int cols)
```
    このレイアウトの列数を、指定された値に設定します。コンストラクタまたは setRows メソッドによって指定された行の数がゼロでない場合は、列数の設定はレイアウトに影響しません。その場合、レイアウトに表示される列数は、コンポーネントの総数および指定された行の数によって決定されます。
    
    パラメータ:
    cols - このレイアウト内の列数
    
    例外:
    
    IllegalArgumentException - rows と cols の両方の値が 0 に設定されている場合
    導入されたバージョン:
    
    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)
```
    指定された名前で、指定されたコンポーネントをレイアウトに追加します。
    
    定義:
    
    addLayoutComponent、インタフェース: LayoutManager
    
    パラメータ:
    name - コンポーネントの名前
    comp - 追加されるコンポーネント
  - removeLayoutComponent
```
public void removeLayoutComponent(Component comp)
```
    指定されたコンポーネントをレイアウトから削除します。
    
    定義:
    
    removeLayoutComponent、インタフェース: LayoutManager
    
    パラメータ:
    comp - 削除されるコンポーネント
  - preferredLayoutSize
```
public Dimension preferredLayoutSize(Container parent)
```
    このグリッドレイアウトを使って、コンテナ引数の推奨サイズを指定します。
    グリッドレイアウトの推奨幅は、コンテナ内のすべてのコンポーネントの最大推奨幅に列数をかけ、水平パディングに列数マイナス 1 倍したものを足し、さらにターゲットコンテナの右と左のインセットを足した幅になります。
    グリッドレイアウトの推奨高さは、コンテナ内のすべてのコンポーネントの最大推奨高さに行数をかけ、垂直パディングに行数マイナス 1 倍したものを足し、さらにターゲットコンテナの上と下のインセットを足した高さになります。
    
    定義:
    
    preferredLayoutSize、インタフェース: LayoutManager
    
    パラメータ:
    parent - レイアウトが行われるコンテナ
    
    戻り値:
    指定されたコンテナのサブコンポーネントを配置するための望ましい寸法
    関連項目:
    minimumLayoutSize(java.awt.Container), Container.getPreferredSize()
  - minimumLayoutSize
```
public Dimension minimumLayoutSize(Container parent)
```
    このグリッドレイアウトを使って、コンテナ引数の最小サイズを指定します。
    グリッドレイアウトの最小幅は、コンテナ内のすべてのコンポーネントの最大最小値に列数をかけ、水平パディングに列数マイナス 1 倍したものを足し、さらにターゲットコンテナの右と左のインセットを足した幅になります。
    グリッドレイアウトの最小高さは、コンテナ内のすべてのコンポーネントの最大最小高さに行数をかけ、垂直パディングに行数マイナス 1 倍したものを足し、さらにターゲットコンテナの上と下のインセットを足した高さになります。
    
    定義:
    
    minimumLayoutSize、インタフェース: LayoutManager
    
    パラメータ:
    parent - レイアウトが行われるコンテナ
    
    戻り値:
    指定されたコンテナのサブコンポーネントを配置するために必要な最小の寸法
    関連項目:
    preferredLayoutSize(java.awt.Container), Container.doLayout()
  - layoutContainer
```
public void layoutContainer(Container parent)
```
    このレイアウトを使って、指定されたコンテナを配置します。
    このメソッドは、GridLayout オブジェクトの制約を満たすために、指定されたターゲットコンテナ内のコンポーネントの形状を変更します。
    グリッドレイアウトマネージャーは、個別のコンポーネントのサイズを指定するために、コンテナ内の空き領域をレイアウトの行数と列数に従って等分します。コンテナの空き領域は、コンテナのサイズから、任意のインセットおよび指定された任意の水平または垂直の間隔を引いたものに等しくなります。グリッドレイアウト内のコンポーネントはすべて、同じサイズに設定されます。
    
    定義:
    
    layoutContainer、インタフェース: LayoutManager
    
    パラメータ:
    parent - レイアウトが行われるコンテナ
    関連項目:
    Container, Container.doLayout()
  - toString
```
public String toString()
```
    このグリッドレイアウトの値の文字列表現を返します。
    
    オーバーライド:
    
    toString、クラス: Object
    
    戻り値:
    このグリッドレイアウトの文字列表現

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.


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

クラス GridLayout

コンストラクタのサマリー

メソッドのサマリー

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

コンストラクタの詳細

GridLayout

GridLayout

GridLayout

メソッドの詳細

getRows

setRows

getColumns

setColumns

getHgap

setHgap

getVgap

setVgap

addLayoutComponent

removeLayoutComponent

preferredLayoutSize

minimumLayoutSize

layoutContainer

toString