java.awt
クラス GridBagConstraints

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

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

Cloneable, Serializable

public class GridBagConstraints

extends Object

implements Cloneable, Serializable

GridBagConstraints クラスは、GridBagLayout クラスを使って配置されるコンポーネントの制約を指定します。

導入されたバージョン:

JDK1.0

関連項目:

GridBagLayout, 直列化された形式

フィールドの概要

int	anchor コンポーネントがその表示領域より小さいときに使用されます。
static int	BOTH コンポーネントを水平と垂直のどちらにもサイズ変更します。
static int	CENTER コンポーネントをその表示領域の中央に配置します。
static int	EAST コンポーネントをその表示領域の右端の上下中央に配置します。
int	fill コンポーネントの表示領域がコンポーネントの必須サイズよりも大きいときに使用されます。
int	gridheight コンポーネントの表示領域の 1 列のセル数を指定します。
int	gridwidth コンポーネントの表示領域の 1 行のセル数を指定します。
int	gridx コンポーネントの表示領域の左部にセルを指定します。
int	gridy コンポーネントの表示領域の上部にセルを指定します。
static int	HORIZONTAL コンポーネントを水平にサイズ変更し、垂直にはサイズ変更しません。
Insets	insets コンポーネントの外側のパディング、つまりコンポーネントとその表示領域の端までの領域の最小値を指定します。
int	ipadx コンポーネントの内側のパディング、つまりコンポーネントの最小幅に追加する領域の値を指定します。
int	ipady コンポーネントの内側のパディング、つまりコンポーネントの最小の高さに追加する領域の値を指定します。
static int	NONE コンポーネントのサイズを変更しません。
static int	NORTH コンポーネントをその表示領域の上端の左右中央に配置します。
static int	NORTHEAST コンポーネントをその表示領域の右上隅に配置します。
static int	NORTHWEST コンポーネントをその表示領域の左上隅に配置します。
static int	RELATIVE このコンポーネントが、列または行 (gridwidth, gridheight) の最終コンポーネントの隣り、または直前に追加されたコンポーネント (gridx, gridy) の隣りに配置されることを指定します。
static int	REMAINDER このコンポーネントが列または行の最後のコンポーネントであるように指定します。
static int	SOUTH コンポーネントをその表示領域の下端の左右中央に配置します。
static int	SOUTHEAST コンポーネントをその表示領域の右下隅に配置します。
static int	SOUTHWEST コンポーネントをその表示領域の左下隅に配置します。
static int	VERTICAL コンポーネントを垂直にサイズ変更し、水平にはサイズ変更しません。
double	weightx 余分の水平スペースを分配する方法を指定します。
double	weighty 垂直の余分なスペースを分配する方法を指定します。
static int	WEST コンポーネントをその表示領域の左端の上下中央に配置します。

コンストラクタの概要

GridBagConstraints()
すべてのフィールドを既定値に設定して GridBagConstraint オブジェクトを作成します。

GridBagConstraints(int gridx, int gridy, int gridwidth, int gridheight, double weightx, double weighty, int anchor, int fill, Insets insets, int ipadx, int ipady)
すべてのフィールドを渡された引数に設定して GridBagConstraints オブジェクトを作成します。

メソッドの概要

Object

clone() このグリッドバッグ制約のコピーを作成します。

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

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

フィールドの詳細

RELATIVE

public static final int RELATIVE

このコンポーネントが、列または行 (gridwidth, gridheight) の最終コンポーネントの隣り、または直前に追加されたコンポーネント (gridx, gridy) の隣りに配置されることを指定します。

関連項目:

gridwidth, gridheight, gridx, gridy

REMAINDER

public static final int REMAINDER

このコンポーネントが列または行の最後のコンポーネントであるように指定します。

NONE

public static final int NONE

コンポーネントのサイズを変更しません。

BOTH

public static final int BOTH

コンポーネントを水平と垂直のどちらにもサイズ変更します。

HORIZONTAL

public static final int HORIZONTAL

コンポーネントを水平にサイズ変更し、垂直にはサイズ変更しません。

VERTICAL

public static final int VERTICAL

コンポーネントを垂直にサイズ変更し、水平にはサイズ変更しません。

CENTER

public static final int CENTER

コンポーネントをその表示領域の中央に配置します。

NORTH

public static final int NORTH

コンポーネントをその表示領域の上端の左右中央に配置します。

NORTHEAST

public static final int NORTHEAST

コンポーネントをその表示領域の右上隅に配置します。

EAST

public static final int EAST

コンポーネントをその表示領域の右端の上下中央に配置します。

SOUTHEAST

public static final int SOUTHEAST

コンポーネントをその表示領域の右下隅に配置します。

SOUTH

public static final int SOUTH

コンポーネントをその表示領域の下端の左右中央に配置します。

SOUTHWEST

public static final int SOUTHWEST

コンポーネントをその表示領域の左下隅に配置します。

WEST

public static final int WEST

コンポーネントをその表示領域の左端の上下中央に配置します。

NORTHWEST

public static final int NORTHWEST

コンポーネントをその表示領域の左上隅に配置します。

gridx

public int gridx

コンポーネントの表示領域の左部にセルを指定します。左端のセルは gridx=0 を持ちます。値 RELATIVE は、このコンポーネントを直前にコンテナに追加されたコンポーネントの右隣りに配置するように指定します。

既定値は RELATIVE です。gridx には負の値を指定することはできません。

関連項目:

clone(), gridy

gridy

public int gridy

コンポーネントの表示領域の上部にセルを指定します。上端のセルは gridy=0 を持ちます。値 RELATIVE は、このコンポーネントを直前にコンテナに追加されたコンポーネントの真下に配置するように指定します。

既定値は RELATIVE です。gridy には負の値を指定することはできません。

関連項目:

clone(), gridx

gridwidth

public int gridwidth

コンポーネントの表示領域の 1 行のセル数を指定します。

コンポーネントがその行の最後のコンポーネントであることを指定する場合は、REMAINDER を設定します。次のコンポーネントで、その行が終了することを指定する場合は、RELATIVE を設定します。

gridwidth には負の値を指定することはできません。既定値は 1 です。

関連項目:

clone(), gridheight

gridheight

public int gridheight

コンポーネントの表示領域の 1 列のセル数を指定します。

コンポーネントがその列の最後のコンポーネントであることを指定する場合は、REMAINDER を設定します。次のコンポーネントで、その列が終了することを指定する場合は、RELATIVE を設定します。

gridheight には負の値を指定することはできません。既定値は 1 です。

関連項目:

clone(), gridwidth

weightx

public double weightx

余分の水平スペースを分配する方法を指定します。

グリッドバッグレイアウトマネージャは、1 列のウェイトが 1 列のすべてのコンポーネントの最大の weightx になるように計算します。結果のレイアウトが塗りつぶす必要のある領域の幅より小さい場合、余分のスペースが各列のウェイトに比例して分配されます。ウェイトがゼロの列には、余分のスペースは分配されません。

すべてのウェイトがゼロの場合、すべての余分のスペースがセルのグリッドと左右両端の間に表示されます。

このフィールドの既定値は 0 です。weightx には負の値を指定することはできません。

関連項目:

clone(), weighty

weighty

public double weighty

垂直の余分なスペースを分配する方法を指定します。

グリッドバッグレイアウトマネージャは、1 行のウェイトが 1 行のすべてのコンポーネントの最大の weighty になるように計算します。結果のレイアウトが塗りつぶす必要のある領域の高さより小さい場合、余分のスペースが各行のウェイトに比例して分配されます。ウェイトがゼロの行には、余分のスペースは分配されません。

すべてのウェイトがゼロの場合、すべての余分のスペースがセルのグリッドと上下の両端の間に表示されます。

このフィールドの既定値は 0 です。weighty には負の値を指定することはできません。

関連項目:

clone(), weightx

anchor

public int anchor

コンポーネントがその表示領域より小さいときに使用されます。これは、表示領域内のどこに、コンポーネントを配置するかを指定します。指定できる値には、CENTER、NORTH、NORTHEAST、EAST、SOUTHEAST、SOUTH、SOUTHWEST、WEST、および NORTHWEST があります。既定値は CENTER です。

関連項目:

clone()

fill

public int fill

コンポーネントの表示領域がコンポーネントの必須サイズよりも大きいときに使用されます。これは、コンポーネントをサイズ変更するかどうかを指定し、サイズ変更を行う場合にはその方法も指定します。

fill には、次の値が有効です。

• NONE: コンポーネントのサイズ変更をしない
• HORIZONTAL: コンポーネントの幅を水平表示領域の最大サイズにし、高さは変更しない
• VERTICAL: コンポーネントの高さを垂直表示領域の最大サイズにし、幅は変更しない
• BOTH: コンポーネントを表示領域の最大サイズにする

既定値は NONE です。

関連項目:

clone()

insets

public Insets insets

コンポーネントの外側のパディング、つまりコンポーネントとその表示領域の端までの領域の最小値を指定します。

既定値は new Insets(0, 0, 0, 0) です。

関連項目:

clone()

ipadx

public int ipadx

コンポーネントの内側のパディング、つまりコンポーネントの最小幅に追加する領域の値を指定します。コンポーネントの幅は、少なくともその最小幅に (ipadx * 2) ピクセルを足したものです。

既定値は 0 です。

関連項目:

clone(), ipady

ipady

public int ipady

コンポーネントの内側のパディング、つまりコンポーネントの最小の高さに追加する領域の値を指定します。コンポーネントの高さは、少なくともその最小の高さに (ipady * 2) ピクセルを足したものです。

既定値は 0 です。

関連項目:

clone(), ipadx

コンストラクタの詳細

GridBagConstraints

public GridBagConstraints()

すべてのフィールドを既定値に設定して GridBagConstraint オブジェクトを作成します。

GridBagConstraints

public GridBagConstraints(int gridx,
                          int gridy,
                          int gridwidth,
                          int gridheight,
                          double weightx,
                          double weighty,
                          int anchor,
                          int fill,
                          Insets insets,
                          int ipadx,
                          int ipady)

すべてのフィールドを渡された引数に設定して GridBagConstraints オブジェクトを作成します。 注: このコンストラクタを使用するとソースコードが読みにくくなるので、このコンストラクタは自動ソースコード生成ツールでのみ使用してください。

パラメータ:

gridx - 初期 gridx 値

gridy - 初期 gridy 値

gridwidth - 初期 gridwidth 値

gridheight - 初期 gridheight 値

weightx - 初期 weightx 値

weighty - 初期 weighty 値

anchor - 初期 anchor 値

fill - 初期 fill 値

insets - 初期 insets 値

ipadx - 初期 ipadx 値

ipady - 初期 ipady 値

導入されたバージョン:

1.2

関連項目:

gridx, gridy, gridwidth, gridheight, weightx, weighty, anchor, fill, insets, ipadx, ipady

メソッドの詳細

clone

public Object clone()

このグリッドバッグ制約のコピーを作成します。

オーバーライド:

クラス Object 内の clone

戻り値:

このグリッドバッグ制約のコピー