GridBagLayout (Java Platform SE 7)

java.lang.Object
- java.awt.GridBagLayout

すべての実装されたインタフェース:: LayoutManager, LayoutManager2, Serializable

public class GridBagLayout
extends Object
implements LayoutManager2, Serializable

GridBagLayout クラスは、コンポーネントが同じサイズであることを要求することなく、コンポーネントを垂直方向に、水平方向に、またはベースラインに沿って配置する柔軟なレイアウトマネージャーです。それぞれの GridBagLayout オブジェクトは、セルによって構成される動的な矩形グリッドを格納しています。各コンポーネントは、1 つ以上のセル (表示領域と呼ぶ) に配置されます。

GridBagLayout によって管理される各コンポーネントは、GridBagConstraints のインスタンスと関連します。制約オブジェクトは、コンポーネントの表示領域をグリッド上に配置する場所、およびコンポーネントをその表示領域内に配置する方法を指定します。また、この制約オブジェクトに加え、GridBagLayout は、コンポーネントのサイズを決定するために、各コンポーネントの最小サイズおよび推奨サイズを考慮します。

グリッドの全体の方向は、コンテナの ComponentOrientation プロパティーによって決まります。水平方向に左から右の場合、グリッドの座標 (0, 0) はコンテナの左上隅になります。この場合、X 座標は右方向に、Y 座標は下方向に値が増加します。水平方向に右から左の場合、グリッドの座標 (0, 0) はコンテナの右上隅になります。この場合、X 座標は左方向に、Y 座標は下方向に値が増加します。

グリッドバッグレイアウトを効果的に利用するには、コンポーネントの少なくとも 1 つの GridBagConstraints オブジェクトをカスタマイズする必要があります。 GridBagConstraints オブジェクトをカスタマイズするには、1 つまたは複数のインスタンス変数を設定します。

GridBagConstraints.gridx, GridBagConstraints.gridy: コンポーネントの表示領域のリーディングコーナーを格納するセルを指定します。グリッドの原点にあるセルのアドレスは gridx = 0、gridy = 0 です。水平方向に左から右へのレイアウトの場合、コンポーネントのリーディングコーナーは左上隅です。水平方向に右から左へのレイアウトの場合、コンポーネントのリーディングコーナーは右上隅です。 GridBagConstraints.RELATIVE (デフォルト値) を使用して、コンポーネントを、このコンポーネントが追加される直前にコンテナに追加されたコンポーネントの直後に (gridx は x 軸に沿って、gridy は y 軸に沿って) 配置するよう指定します。
GridBagConstraints.gridwidth, GridBagConstraints.gridheight: コンポーネントの表示領域における 1 行 (gridwidth) または 1 列 (gridheight) あたりのセルの数を指定します。デフォルト値は 1 です。コンポーネントの表示領域が gridx から行の最後のセルまで (gridwidth) または gridy から列の最後のセルまで (gridheight) であることを指定する場合は、GridBagConstraints.REMAINDER を使用します。コンポーネントの表示領域が gridx から、行の最後から 2 番目のセルまで (gridwidth)、または gridy から、列の最後から 2 番目のセルまで (gridheight) であることを指定する場合は、GridBagConstraints.RELATIVE を使用します。
GridBagConstraints.fill: コンポーネントの表示領域が、必要とするサイズよりも大きい場合には、コンポーネントのサイズ変更を行うかどうかと変更の方法を決定するために使用されます。指定できる値は、GridBagConstraints.NONE (デフォルト)、GridBagConstraints.HORIZONTAL (コンポーネントの高さは変更せずに、幅を表示領域最大にする)、GridBagConstraints.VERTICAL (コンポーネントの幅は変更せずに、高さを表示領域最大にする)、GridBagConstraints.BOTH (コンポーネントを表示領域最大にする) です。
GridBagConstraints.ipadx, GridBagConstraints.ipady: レイアウト内のコンポーネントの内側のパディング (コンポーネントの最小サイズに追加する値) を指定します。コンポーネントの幅は、少なくとも最小の幅 + ipadx ピクセルとなります。同様に、コンポーネントの高さは、少なくとも最小の高さ + ipady ピクセルとなります。
GridBagConstraints.insets: コンポーネントの外側のパディング、つまりコンポーネントと表示領域の端との間の最小の空間を指定します。
GridBagConstraints.anchor: 表示領域内のコンポーネントの位置を指定します。取り得る値には、絶対値、方向相対値、ベースライン相対値の 3 種類があります。方向相対値はコンテナの ComponentOrientation プロパティーを基準にして解釈されますが、絶対値には解釈はありません。ベースライン相対値は、ベースラインを基準にして計算されます。有効な値は次のとおりです。
GridBagConstraints.weightx, GridBagConstraints.weighty: スペースの分配方法を決定するために使用されます。これは、サイズ変更の動作を指定するために重要です。 1 行 (weightx) または 1 列 (weighty) につき、少なくとも 1 つのコンポーネントにウェイトを設定しないかぎり、すべてのコンポーネントがコンテナの中央に集まります。これは、ウェイトが 0 の場合 (デフォルト) には、GridBagLayout オブジェクトが余分なスペースをすべてセルのグリッドとコンテナの端の間に配置してしまうからです。

絶対値	方向相対値	ベースライン相対値
`GridBagConstraints.NORTH` `GridBagConstraints.SOUTH` `GridBagConstraints.WEST` `GridBagConstraints.EAST` `GridBagConstraints.NORTHWEST` `GridBagConstraints.NORTHEAST` `GridBagConstraints.SOUTHWEST` `GridBagConstraints.SOUTHEAST` `GridBagConstraints.CENTER` (デフォルト)	`GridBagConstraints.PAGE_START` `GridBagConstraints.PAGE_END` `GridBagConstraints.LINE_START` `GridBagConstraints.LINE_END` `GridBagConstraints.FIRST_LINE_START` `GridBagConstraints.FIRST_LINE_END` `GridBagConstraints.LAST_LINE_START` `GridBagConstraints.LAST_LINE_END`	`GridBagConstraints.BASELINE` `GridBagConstraints.BASELINE_LEADING` `GridBagConstraints.BASELINE_TRAILING` `GridBagConstraints.ABOVE_BASELINE` `GridBagConstraints.ABOVE_BASELINE_LEADING` `GridBagConstraints.ABOVE_BASELINE_TRAILING` `GridBagConstraints.BELOW_BASELINE` `GridBagConstraints.BELOW_BASELINE_LEADING` `GridBagConstraints.BELOW_BASELINE_TRAILING`

各行にはベースラインがある場合があります。行のベースラインは、その行で有効なベースラインを持つコンポーネントによって決定され、コンポーネントはベースラインに沿って配置されます。コンポーネントの anchor 値は、BASELINE、BASELINE_LEADING、BASELINE_TRAILING のいずれかです。行内でいずれのコンポーネントも有効なベースラインを持たない場合、その行にベースラインはありません。

複数の行にまたがるようなコンポーネントは、開始行のベースライン (ベースラインサイズ変更動作が CONSTANT_ASCENT の場合)、または終了行のベースライン (ベースラインサイズ変更動作が CONSTANT_DESCENT の場合) に沿って配置されます。コンポーネントが沿う行は、支配行と呼ばれます。

次の図に、ベースラインのレイアウトを示します。この図では複数行にまたがるコンポーネントが存在します。

このレイアウトには 3 つのコンポーネントがあります。

行 0 から始まり、行 1 で終わるパネル。パネルにはベースラインサイズ変更動作 CONSTANT_DESCENT とアンカー BASELINE が設定されています。ベースラインサイズ変更動作が CONSTANT_DESCENT であるため、パネルの支配行は行 1 です。
2 つのボタン。それぞれベースラインサイズ変更動作 CENTER_OFFSET とアンカー BASELINE が設定されています。

2 番目のボタンとパネルが同じ支配行を共有しているため、どちらも各自のベースラインに沿って配置されています。

ベースライン相対値のいずれかを使用して配置されたコンポーネントは、絶対値または方向相対値を使用して配置した場合と異なる方法でサイズが変更されます。コンポーネントの変更方法は、支配行のベースラインの変更方法によって指示されます。同じ支配行を持つ任意のコンポーネントでベースラインサイズ変更動作 CONSTANT_DESCENT が設定されている場合、ベースラインは表示領域の下端にアンカー設定されます。そうでない場合、ベースラインは表示領域の上端にアンカー設定されます。次の規則によってサイズ変更動作が指示されます。

ベースラインより上に配置されたサイズ変更可能コンポーネントは、ベースラインと同じ高さまでしか高くすることはできません。たとえばベースラインが 100 で、上端にアンカー設定されている場合、ベースラインより上に配置されたサイズ変更可能コンポーネントは 100 単位よりも高くすることはできません。
同様に、ベースラインより下に配置されたサイズ変更可能コンポーネントは、表示高さとベースラインの間隔よりも高くすることはできません。
ベースラインに配置され、ベースラインサイズ変更動作 OTHER が設定されたサイズ変更可能コンポーネントの場合は、サイズ変更後のサイズのベースラインが表示領域に収まる場合に限り、サイズ変更されます。ベースラインが表示領域内に収まらなくなる場合、コンポーネントはサイズ変更されません。
ベースラインサイズ変更動作が OTHER ではないベースラインに配置されたコンポーネントは、display height - baseline + baseline of component まで高くすることができます。

ベースラインに沿ってコンポーネントを配置したが、そのコンポーネントに有効なベースラインがない場合は、コンポーネントの空間内で垂直方向に中央揃えされます。同様に、ベースラインを基準にコンポーネントを配置したが、行内のどのコンポーネントも有効なベースラインを持たない場合、そのコンポーネントは垂直方向に中央揃えされます。

次に示す図は、グリッドバッグレイアウトによって管理される 10 個のコンポーネント (すべてのボタン) を示します。図 2 は水平方向に左から右へのコンテナを示し、図 3 は水平方向に右から左へのコンテナを示します。


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

10 個のコンポーネントのそれぞれは、その関連している GridBagConstraints オブジェクトの fill フィールドが GridBagConstraints.BOTH に設定されています。さらにコンポーネントは、デフォルトとは異なる次の制約を持っています。

Button1、Button2、Button3: weightx = 1.0
Button4: weightx = 1.0, gridwidth = GridBagConstraints.REMAINDER
Button5: gridwidth = GridBagConstraints.REMAINDER
Button6: gridwidth = GridBagConstraints.RELATIVE
Button7: gridwidth = GridBagConstraints.REMAINDER
Button8: gridheight = 2, weighty = 1.0
Button9、Button 10: gridwidth = GridBagConstraints.REMAINDER

上記の例を実装したサンプルコードを示します。

 import java.awt.*;
 import java.util.*;
 import java.applet.Applet;

 public class GridBagEx1 extends Applet {

     protected void makebutton(String name,
                               GridBagLayout gridbag,
                               GridBagConstraints c) {
         Button button = new Button(name);
         gridbag.setConstraints(button, c);
         add(button);
     }

     public void init() {
         GridBagLayout gridbag = new GridBagLayout();
         GridBagConstraints c = new GridBagConstraints();

         setFont(new Font("SansSerif", Font.PLAIN, 14));
         setLayout(gridbag);

         c.fill = GridBagConstraints.BOTH;
         c.weightx = 1.0;
         makebutton("Button1", gridbag, c);
         makebutton("Button2", gridbag, c);
         makebutton("Button3", gridbag, c);

         c.gridwidth = GridBagConstraints.REMAINDER; //end row
         makebutton("Button4", gridbag, c);

         c.weightx = 0.0;                //reset to the default
         makebutton("Button5", gridbag, c); //another row

         c.gridwidth = GridBagConstraints.RELATIVE; //next-to-last in row
         makebutton("Button6", gridbag, c);

         c.gridwidth = GridBagConstraints.REMAINDER; //end row
         makebutton("Button7", gridbag, c);

         c.gridwidth = 1;                //reset to the default
         c.gridheight = 2;
         c.weighty = 1.0;
         makebutton("Button8", gridbag, c);

         c.weighty = 0.0;                //reset to the default
         c.gridwidth = GridBagConstraints.REMAINDER; //end row
         c.gridheight = 1;               //reset to the default
         makebutton("Button9", gridbag, c);
         makebutton("Button10", gridbag, c);

         setSize(300, 100);
     }

     public static void main(String args[]) {
         Frame f = new Frame("GridBag Layout Example");
         GridBagEx1 ex1 = new GridBagEx1();

         ex1.init();

         f.add("Center", ex1);
         f.pack();
         f.setSize(f.getPreferredSize());
         f.show();
     }
 }

導入されたバージョン:: JDK1.0
関連項目:: GridBagConstraints, GridBagLayoutInfo, ComponentOrientation, 直列化された形式

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`double[]`	`columnWeights` このフィールドは、列のウェイトに対するオーバーライドを保持します。
`int[]`	`columnWidths` このフィールドは、列の最小幅に対するオーバーライドを保持します。
`protected Hashtable<Component,GridBagConstraints>`	`comptable` このハッシュテーブルは、コンポーネントとコンポーネントのグリッドバッグ制約との関連性を維持します。
`protected GridBagConstraints`	`defaultConstraints` このフィールドには、デフォルト値を含むグリッドバッグ制約のインスタンスが保持されているため、コンポーネントにグリッドバッグ制約が関連付けられていない場合、そのコンポーネントには `defaultConstraints` のコピーが割り当てられます。
`protected GridBagLayoutInfo`	`layoutInfo` このフィールドは、グリッドバッグのレイアウト情報を保持します。
`protected static int`	`MAXGRIDSIZE` このフィールドは、配列を予約するためには使用されなくなり、下位互換性のために維持されています。
`protected static int`	`MINSIZE` グリッドバッグレイアウトによって配置できる最小のグリッドです。
`protected static int`	`PREFERREDSIZE` グリッドバッグレイアウトによって配置できるグリッドの推奨サイズです。
`int[]`	`rowHeights` このフィールドは、行の最小の高さに対するオーバーライドを保持します。
`double[]`	`rowWeights` このフィールドは、行のウェイトに対するオーバーライドを保持します。

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

コンストラクタ
コンストラクタと説明

GridBagLayout()
グリッドバッグレイアウトマネージャーを作成します。

コンストラクタ
コンストラクタと説明
`GridBagLayout()` グリッドバッグレイアウトマネージャーを作成します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`void`	`addLayoutComponent(Component comp, Object constraints)` 指定された `constraints` オブジェクトを使用して、指定されたコンポーネントをレイアウトに追加します。
`void`	`addLayoutComponent(String name, Component comp)` このレイアウトマネージャーはコンポーネントごとの文字列を使用しないため、何もしません。
`protected void`	`adjustForGravity(GridBagConstraints constraints, Rectangle r)` x、y、幅、高さフィールドを、制約幾何学的図形およびパッドに応じて正しい値に調整します。
`protected void`	`AdjustForGravity(GridBagConstraints constraints, Rectangle r)` このメソッドは廃止されており、下位互換性のためにのみ提供されています。新しいコードは、代わりに `adjustForGravity` を呼び出すようにしてください。
`protected void`	`arrangeGrid(Container parent)` グリッドを配置します。
`protected void`	`ArrangeGrid(Container parent)` このメソッドは廃止されており、下位互換性のためにのみ提供されています。新しいコードは、代わりに `arrangeGrid` を呼び出すようにしてください。
`GridBagConstraints`	`getConstraints(Component comp)` 指定されたコンポーネントの制約を返します。
`float`	`getLayoutAlignmentX(Container parent)` x 軸方向の配置を返します。
`float`	`getLayoutAlignmentY(Container parent)` y 軸方向の配置を返します。
`int[][]`	`getLayoutDimensions()` レイアウトグリッドの列の幅と行の高さを指定します。
`protected GridBagLayoutInfo`	`getLayoutInfo(Container parent, int sizeflag)` 管理される子の現在のセットに対する `GridBagLayoutInfo` のインスタンスに値を入力します。
`protected GridBagLayoutInfo`	`GetLayoutInfo(Container parent, int sizeflag)` このメソッドは廃止されており、下位互換性のためにのみ提供されています。新しいコードは、代わりに `getLayoutInfo` を呼び出すようにしてください。
`Point`	`getLayoutOrigin()` ターゲットコンテナのグラフィックス座標空間内で、レイアウト領域の原点を指定します。
`double[][]`	`getLayoutWeights()` レイアウトグリッドの列と行のウェイトを指定します。
`protected Dimension`	`getMinSize(Container parent, GridBagLayoutInfo info)` `getLayoutInfo` からの情報に基づいて、マスターの最小サイズを計算します。
`protected Dimension`	`GetMinSize(Container parent, GridBagLayoutInfo info)` このメソッドは廃止されており、下位互換性のためにのみ提供されています。新しいコードは、代わりに `getMinSize` を呼び出すようにしてください。
`void`	`invalidateLayout(Container target)` レイアウトを無効にします。このとき、レイアウトマネージャーが情報をキャッシュしていればそれを破棄します。
`void`	`layoutContainer(Container parent)` このグリッドバッグレイアウトを使って指定されたコンテナを配置します。
`Point`	`location(int x, int y)` `(x, y)` によって指定された点がレイアウトグリッド内のどのセルに含まれているかを判定します。
`protected GridBagConstraints`	`lookupConstraints(Component comp)` 指定されたコンポーネントの制約を返します。
`Dimension`	`maximumLayoutSize(Container target)` 指定されたターゲットコンテナにコンポーネントが与えられた場合の、レイアウトの最大サイズを返します。
`Dimension`	`minimumLayoutSize(Container parent)` このグリッドバッグレイアウトを使用して、`parent` コンテナの最小サイズを判定します。
`Dimension`	`preferredLayoutSize(Container parent)` このグリッドバッグレイアウトを使用して、`parent` コンテナの優先サイズを判定します。
`void`	`removeLayoutComponent(Component comp)` 指定されたコンポーネントをこのレイアウトから削除します。
`void`	`setConstraints(Component comp, GridBagConstraints constraints)` このレイアウトの指定されたコンポーネントに対して制約を設定します。
`String`	`toString()` グリッドバッグレイアウトの値の文字列表現を返します。

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- フィールドの詳細
  - MAXGRIDSIZE
```
protected static final int MAXGRIDSIZE
```
    このフィールドは、配列を予約するためには使用されなくなり、下位互換性のために維持されています。以前は、グリッドバッグレイアウトによって配置できるグリッド位置 (縦横どちらとも) の最大数でした。現在の実装では、グリッドサイズに制限はありません。
    
    関連項目:
    定数フィールド値
  - MINSIZE
```
protected static final int MINSIZE
```
    グリッドバッグレイアウトによって配置できる最小のグリッドです。
    
    関連項目:
    定数フィールド値
  - PREFERREDSIZE
```
protected static final int PREFERREDSIZE
```
    グリッドバッグレイアウトによって配置できるグリッドの推奨サイズです。
    
    関連項目:
    定数フィールド値
  - comptable
```
protected Hashtable<Component,GridBagConstraints> comptable
```
    このハッシュテーブルは、コンポーネントとコンポーネントのグリッドバッグ制約との関連性を維持します。comptable 内のキーはコンポーネントで、値は GridBagConstraints のインスタンスです。
    
    関連項目:
    GridBagConstraints
  - defaultConstraints
```
protected GridBagConstraints defaultConstraints
```
    このフィールドには、デフォルト値を含むグリッドバッグ制約のインスタンスが保持されているため、コンポーネントにグリッドバッグ制約が関連付けられていない場合、そのコンポーネントには defaultConstraints のコピーが割り当てられます。
    
    関連項目:
    getConstraints(Component), setConstraints(Component, GridBagConstraints), lookupConstraints(Component)
  - layoutInfo
```
protected GridBagLayoutInfo layoutInfo
```
    このフィールドは、グリッドバッグのレイアウト情報を保持します。このフィールドの情報は、グリッドバッグの最新の検査に基づきます。layoutInfo が null の場合は、グリッドバッグにコンポーネントがないか、またはコンポーネントがあってもそれがまだ検査を受けていないことを意味します。
    
    関連項目:
    getLayoutInfo(Container, int)
  - columnWidths
```
public int[] columnWidths
```
    このフィールドは、列の最小幅に対するオーバーライドを保持します。このフィールドが null ではない場合、すべての最小列幅が計算されたあとで、その値がグリッドバッグに適用されます。columnWidths に列数より多くの要素がある場合、columnWidth の要素数に合わせるためにグリッドバッグに列が追加されます。
    
    関連項目:
    getLayoutDimensions()
  - rowHeights
```
public int[] rowHeights
```
    このフィールドは、行の最小の高さに対するオーバーライドを保持します。このフィールドが null ではない場合、すべての最小の行の高さが計算されたあとで、その値がグリッドバッグに適用されます。rowHeights に行数より多くの要素がある場合、rowHeights の要素数に合わせるために、グリッドバッグに行が追加されます。
    
    関連項目:
    getLayoutDimensions()
  - columnWeights
```
public double[] columnWeights
```
    このフィールドは、列のウェイトに対するオーバーライドを保持します。このフィールドが null ではない場合、すべての列のウェイトが計算されたあとで、その値がグリッドバッグに適用されます。columnWeights[i] > 列 i のウェイトの場合は、列 i に columnWeights[i] のウェイトが割り当てられます。columnWeights に列数より多くの要素がある場合、超過した要素は無視され、列の作成は行われません。
  - rowWeights
```
public double[] rowWeights
```
    このフィールドは、行のウェイトに対するオーバーライドを保持します。このフィールドが null ではない場合、すべての行のウェイトが計算されたあとで、その値がグリッドバッグに適用されます。rowWeights[i] > 行 i のウェイトの場合は、行 i に rowWeights[i] のウェイトが割り当てられます。rowWeights に行数より多くの要素がある場合、超過した要素は無視され、行の作成は行われません。
- コンストラクタの詳細
  - GridBagLayout
```
public GridBagLayout()
```
    グリッドバッグレイアウトマネージャーを作成します。
- メソッドの詳細
  - setConstraints
```
public void setConstraints(Component comp,
                  GridBagConstraints constraints)
```
    このレイアウトの指定されたコンポーネントに対して制約を設定します。
    
    パラメータ:
    comp - 変更されるコンポーネント
    constraints - 適用される制約
  - getConstraints
```
public GridBagConstraints getConstraints(Component comp)
```
    指定されたコンポーネントの制約を返します。実際の GridBagConstraints オブジェクトのコピーが返されます。
    
    パラメータ:
    comp - 照会されるコンポーネント
    
    戻り値:
    このグリッドバッグレイアウトで指定されたコンポーネントの制約、つまり実際の制約オブジェクトのコピーが返される
  - lookupConstraints
```
protected GridBagConstraints lookupConstraints(Component comp)
```
    指定されたコンポーネントの制約を返します。戻り値はコピーではなく、配置メカニズムで使用される実際の GridBagConstraints オブジェクトです。
    comp が GridBagLayout にない場合、一連のデフォルトの GridBagConstraints が返されます。 null の comp 値は無効で、null が返されます。
    
    パラメータ:
    comp - 照会されるコンポーネント
    
    戻り値:
    指定されたコンポーネントの制約
  - getLayoutOrigin
```
public Point getLayoutOrigin()
```
    ターゲットコンテナのグラフィックス座標空間内で、レイアウト領域の原点を指定します。この値はコンテナの ComponentOrientation の値とは関係なく、レイアウト領域の左上隅のピクセル座標を表します。これは、セル座標 (0,0) によって指定されるグリッドの原点とは異なります。ほとんどのアプリケーションはこのメソッドを直接には呼び出しません。
    
    戻り値:
    レイアウトグリッドの左上隅にあるセルのグラフィックスの原点
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    ComponentOrientation
  - getLayoutDimensions
```
public int[][] getLayoutDimensions()
```
    レイアウトグリッドの列の幅と行の高さを指定します。
    ほとんどのアプリケーションはこのメソッドを直接には呼び出しません。
    
    戻り値:
    レイアウト列の幅とレイアウト行の高さを格納する、2 つの配列から構成される配列
    導入されたバージョン:
    
    JDK1.1
  - getLayoutWeights
```
public double[][] getLayoutWeights()
```
    レイアウトグリッドの列と行のウェイトを指定します。ウェイトを使うと、レイアウトに余分な空きスペースがある場合に、指定された列または行をその推奨サイズよりどれだけ拡大できるかを計算できます。
    ほとんどのアプリケーションはこのメソッドを直接には呼び出しません。
    
    戻り値:
    レイアウト列の水平のウェイトとレイアウト行の垂直のウェイトを表現する、2 つの配列から構成される配列
    導入されたバージョン:
    
    JDK1.1
  - location
```
public Point location(int x,
             int y)
```
    (x, y) によって指定された点がレイアウトグリッド内のどのセルに含まれているかを判定します。各セルは列インデックス (0 から列数 - 1) と行インデックス (0 から行数 - 1) で識別されます。
    点 (x, y) がグリッドの外側にある場合、次の規則が適用されます。 x が左から右方向のコンテナのレイアウトの左にある場合、または右から左方向のコンテナのレイアウトの右にある場合、列インデックスはゼロが返されます。 x が左から右方向のコンテナのレイアウトの右にある場合、または右から左方向のコンテナのレイアウトの左にある場合、列インデックスは列数が返されます。 y がレイアウトの上にある場合は、行インデックスはゼロが返され、y がレイアウトの下にある場合は、行数が返されます。コンテナの方向は、その ComponentOrientation プロパティーによって指定されます。
    
    パラメータ:
    x - 点の x 座標
    y - 点の y 座標
    
    戻り値:
    レイアウトグリッドのどのセルが点 (x, y) を格納しているかを示す順序付きペアのインデックス。
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    ComponentOrientation
  - addLayoutComponent
```
public void addLayoutComponent(String name,
                      Component comp)
```
    このレイアウトマネージャーはコンポーネントごとの文字列を使用しないため、何もしません。
    
    定義:
    
    addLayoutComponent、インタフェース: LayoutManager
    
    パラメータ:
    name - コンポーネントに関連付けられる文字列
    comp - 追加されるコンポーネント
  - addLayoutComponent
```
public void addLayoutComponent(Component comp,
                      Object constraints)
```
    指定された constraints オブジェクトを使用して、指定されたコンポーネントをレイアウトに追加します。制約は可変であり、そのためキャッシュ時に複製されることに注意します。
    
    定義:
    
    addLayoutComponent、インタフェース: LayoutManager2
    
    パラメータ:
    comp - 追加されるコンポーネント
    constraints - コンポーネントをレイアウトに追加する方法を指定するオブジェクト
    
    例外:
    
    IllegalArgumentException - constraints が GridBagConstraint ではない場合
  - removeLayoutComponent
```
public void removeLayoutComponent(Component comp)
```
    指定されたコンポーネントをこのレイアウトから削除します。
    ほとんどのアプリケーションはこのメソッドを直接には呼び出しません。
    
    定義:
    
    removeLayoutComponent、インタフェース: LayoutManager
    
    パラメータ:
    comp - 削除されるコンポーネント。
    関連項目:
    Container.remove(java.awt.Component), Container.removeAll()
  - preferredLayoutSize
```
public Dimension preferredLayoutSize(Container parent)
```
    このグリッドバッグレイアウトを使用して、parent コンテナの優先サイズを判定します。
    ほとんどのアプリケーションはこのメソッドを直接には呼び出しません。
    
    定義:
    
    preferredLayoutSize、インタフェース: LayoutManager
    
    パラメータ:
    parent - レイアウトが行われるコンテナ
    
    戻り値:
    parent コンテナの推奨サイズ
    関連項目:
    Container.getPreferredSize()
  - minimumLayoutSize
```
public Dimension minimumLayoutSize(Container parent)
```
    このグリッドバッグレイアウトを使用して、parent コンテナの最小サイズを判定します。
    ほとんどのアプリケーションはこのメソッドを直接には呼び出しません。
    
    定義:
    
    minimumLayoutSize、インタフェース: LayoutManager
    
    パラメータ:
    parent - レイアウトが行われるコンテナ
    
    戻り値:
    parent コンテナの最小サイズ
    関連項目:
    Container.doLayout()
  - maximumLayoutSize
```
public Dimension maximumLayoutSize(Container target)
```
    指定されたターゲットコンテナにコンポーネントが与えられた場合の、レイアウトの最大サイズを返します。
    
    定義:
    
    maximumLayoutSize、インタフェース: LayoutManager2
    
    パラメータ:
    target - 配置する必要があるコンテナ
    
    戻り値:
    このレイアウトの最大サイズ
    関連項目:
    Container, minimumLayoutSize(Container), preferredLayoutSize(Container)
  - getLayoutAlignmentX
```
public float getLayoutAlignmentX(Container parent)
```
    x 軸方向の配置を返します。これは、そのコンポーネントがほかのコンポーネントに対してどのように配置されるべきかを指定したものです。この値は 0 から 1 の間の数値で、0 は原点に沿った配置を表し、1 は原点からもっとも遠いところに、0.5 は中央に配置されます。
    
    定義:
    
    getLayoutAlignmentX、インタフェース: LayoutManager2
    
    戻り値:
    中央への配置を示す値 0.5f
  - getLayoutAlignmentY
```
public float getLayoutAlignmentY(Container parent)
```
    y 軸方向の配置を返します。これは、そのコンポーネントがほかのコンポーネントに対してどのように配置されるべきかを指定したものです。この値は 0 から 1 の間の数値で、0 は原点に沿った配置を表し、1 は原点からもっとも遠いところに、0.5 は中央に配置されます。
    
    定義:
    
    getLayoutAlignmentY、インタフェース: LayoutManager2
    
    戻り値:
    中央への配置を示す値 0.5f
  - invalidateLayout
```
public void invalidateLayout(Container target)
```
    レイアウトを無効にします。このとき、レイアウトマネージャーが情報をキャッシュしていればそれを破棄します。
    
    定義:
    
    invalidateLayout、インタフェース: LayoutManager2
  - layoutContainer
```
public void layoutContainer(Container parent)
```
    このグリッドバッグレイアウトを使って指定されたコンテナを配置します。このメソッドはこの GridBagLayout オブジェクトの制約を満たすために、指定されたコンテナ内のコンポーネントの形状を変更します。
    ほとんどのアプリケーションはこのメソッドを直接には呼び出しません。
    
    定義:
    
    layoutContainer、インタフェース: LayoutManager
    
    パラメータ:
    parent - レイアウトが行われるコンテナ
    関連項目:
    Container, Container.doLayout()
  - toString
```
public String toString()
```
    グリッドバッグレイアウトの値の文字列表現を返します。
    
    オーバーライド:
    
    toString、クラス: Object
    
    戻り値:
    このグリッドバッグレイアウトの文字列の表現
  - getLayoutInfo
```
protected GridBagLayoutInfo getLayoutInfo(Container parent,
                              int sizeflag)
```
    管理される子の現在のセットに対する GridBagLayoutInfo のインスタンスに値を入力します。このインスタンスには、子のセットを通じて、次の 3 つの段階の実行が必要です。
    1. レイアウトグリッドの寸法の計算
    2. コンポーネントを配置するセルの指定
    3. 行または列間へのウェイトと最小サイズの配分
    また、このインスタンスは以降のループでふたたび問い合わせる必要がないように、最初に検出された時点ですべての子の最小サイズをキャッシュします。
    このメソッドは、GridBagLayout が内部的に使用するだけにしてください。
    パラメータ:
    parent - レイアウトコンテナ
    sizeflag - PREFERREDSIZE または MINSIZE
    
    戻り値:
    一連の子の GridBagLayoutInfo
    導入されたバージョン:
    
    1.4
  - GetLayoutInfo
```
protected GridBagLayoutInfo GetLayoutInfo(Container parent,
                              int sizeflag)
```
    このメソッドは廃止されており、下位互換性のためにのみ提供されています。新しいコードは、代わりに getLayoutInfo を呼び出すようにしてください。このメソッドは getLayoutInfo と同じです。パラメータと戻り値の詳細は、getLayoutInfo を参照してください。
  - adjustForGravity
```
protected void adjustForGravity(GridBagConstraints constraints,
                    Rectangle r)
```
    x、y、幅、高さフィールドを、制約幾何学的図形およびパッドに応じて正しい値に調整します。このメソッドは、GridBagLayout が内部的に使用するだけにしてください。
    
    パラメータ:
    constraints - 適用される制約
    r - 調整する Rectangle
    導入されたバージョン:
    
    1.4
  - AdjustForGravity
```
protected void AdjustForGravity(GridBagConstraints constraints,
                    Rectangle r)
```
    このメソッドは廃止されており、下位互換性のためにのみ提供されています。新しいコードは、代わりに adjustForGravity を呼び出すようにしてください。このメソッドは adjustForGravity と同じです。パラメータの詳細は adjustForGravity を参照してください。
  - getMinSize
```
protected Dimension getMinSize(Container parent,
                   GridBagLayoutInfo info)
```
    getLayoutInfo からの情報に基づいて、マスターの最小サイズを計算します。このメソッドは、GridBagLayout が内部的に使用するだけにしてください。
    
    パラメータ:
    parent - レイアウトコンテナ
    info - この親のレイアウト情報
    
    戻り値:
    最小サイズが格納されている Dimension オブジェクト
    導入されたバージョン:
    
    1.4
  - GetMinSize
```
protected Dimension GetMinSize(Container parent,
                   GridBagLayoutInfo info)
```
    このメソッドは廃止されており、下位互換性のためにのみ提供されています。新しいコードは、代わりに getMinSize を呼び出すようにしてください。このメソッドは getMinSize と同じです。パラメータと戻り値の詳細は、getMinSize を参照してください。
  - arrangeGrid
```
protected void arrangeGrid(Container parent)
```
    グリッドを配置します。このメソッドは、GridBagLayout が内部的に使用するだけにしてください。
    
    パラメータ:
    parent - レイアウトコンテナ
    導入されたバージョン:
    
    1.4
  - ArrangeGrid
```
protected void ArrangeGrid(Container parent)
```
    このメソッドは廃止されており、下位互換性のためにのみ提供されています。新しいコードは、代わりに arrangeGrid を呼び出すようにしてください。このメソッドは arrangeGrid と同じです。パラメータの詳細は arrangeGrid を参照してください。

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

クラス GridBagLayout

フィールドのサマリー

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

メソッドのサマリー

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

フィールドの詳細

MAXGRIDSIZE

MINSIZE

PREFERREDSIZE

comptable

defaultConstraints

layoutInfo

columnWidths

rowHeights

columnWeights

rowWeights

コンストラクタの詳細

GridBagLayout

メソッドの詳細

setConstraints

getConstraints

lookupConstraints

getLayoutOrigin

getLayoutDimensions

getLayoutWeights

location

addLayoutComponent

addLayoutComponent

removeLayoutComponent

preferredLayoutSize

minimumLayoutSize

maximumLayoutSize

getLayoutAlignmentX

getLayoutAlignmentY

invalidateLayout

layoutContainer

toString

getLayoutInfo

GetLayoutInfo

adjustForGravity

AdjustForGravity

getMinSize

GetMinSize

arrangeGrid

ArrangeGrid