モジュール java.desktop

パッケージ java.awt

クラスGridBagConstraints

java.lang.Object

java.awt.GridBagConstraints

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

Serializable, Cloneable

public class GridBagConstraints extends Object implements Cloneable, Serializable

GridBagConstraintsクラスは、GridBagLayoutクラスを使用してレイアウトされるコンポーネントの制約を指定します。

導入されたバージョン:

1.0

関連項目:

• GridBagLayout
• 直列化された形式

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
static final int	ABOVE_BASELINE	anchorフィールドが取り得る値。
static final int	ABOVE_BASELINE_LEADING	anchorフィールドが取り得る値。
static final int	ABOVE_BASELINE_TRAILING	anchorフィールドが取り得る値。
int	anchor	このフィールドはコンポーネントがその表示領域より小さい場合に使用されます。
static final int	BASELINE	anchorフィールドが取り得る値。
static final int	BASELINE_LEADING	anchorフィールドが取り得る値。
static final int	BASELINE_TRAILING	anchorフィールドが取り得る値。
static final int	BELOW_BASELINE	anchorフィールドが取り得る値。
static final int	BELOW_BASELINE_LEADING	anchorフィールドが取り得る値。
static final int	BELOW_BASELINE_TRAILING	anchorフィールドが取り得る値。
static final int	BOTH	コンポーネントを水平と垂直のどちらにもサイズ変更します。
static final int	CENTER	コンポーネントをその表示領域の中央に配置します。
static final int	EAST	コンポーネントをその表示領域の右端の上下中央に配置します。
int	fill	コンポーネントの表示領域がコンポーネントの必須サイズよりも大きいときに使用されます。
static final int	FIRST_LINE_END	現在のComponentOrientationで、ページ上のテキストの最初の行が通常終了する表示領域のコーナーにコンポーネントを配置します。
static final int	FIRST_LINE_START	現在のComponentOrientationで、ページ上のテキストの最初の行が通常開始される表示領域のコーナーにコンポーネントを配置します。
int	gridheight	コンポーネントの表示領域の1列のセル数を指定します。
int	gridwidth	コンポーネントの表示領域の1行のセル数を指定します。
int	gridx	コンポーネントの表示領域のリーディング・エッジを含むセルを指定します。ここで、行内の最初のセルにはgridx=0が割り当てられています。
int	gridy	コンポーネントの表示領域のいちばん上にあるセルを指定します。ここで、いちばん上のセルにはgridy=0が割り当てられています。
static final int	HORIZONTAL	コンポーネントを水平にサイズ変更し、垂直にはサイズ変更しません。
Insets	insets	コンポーネントの外側のパディング、つまりコンポーネントとその表示領域の端までの領域の最小値を指定します。
int	ipadx	コンポーネントの内側のパディング、つまりコンポーネントの最小幅に追加する領域の値を指定します。
int	ipady	コンポーネントの内側のパディング、つまりコンポーネントの最小の高さに追加する領域の値を指定します。
static final int	LAST_LINE_END	現在のComponentOrientationで、ページ上のテキストの最終行が通常終了する表示領域のコーナーにコンポーネントを配置します。
static final int	LAST_LINE_START	現在のComponentOrientationで、ページ上のテキストの最終行が通常開始される表示領域のコーナーにコンポーネントを配置します。
static final int	LINE_END	現在のComponentOrientationで、テキスト行が通常終了する表示領域のエッジに沿ってコンポーネントを中央に配置します。
static final int	LINE_START	現在のComponentOrientationで、テキスト行が通常開始される表示領域のエッジに沿ってコンポーネントを中央に配置します。
static final int	NONE	コンポーネントのサイズを変更しません。
static final int	NORTH	コンポーネントをその表示領域の上端の左右中央に配置します。
static final int	NORTHEAST	コンポーネントをその表示領域の右上隅に配置します。
static final int	NORTHWEST	コンポーネントをその表示領域の左上隅に配置します。
static final int	PAGE_END	現在のComponentOrientationで、ページの最後に関連付けられた表示領域のエッジに沿ってコンポーネントを中央に配置します。
static final int	PAGE_START	現在のComponentOrientationで、ページの先頭に関連付けられた表示領域のエッジに沿ってコンポーネントを中央に配置します。
static final int	RELATIVE	このコンポーネントがその列または行(gridwidth、gridheight)内で最後のコンポーネントの隣のコンポーネントであること、またはこのコンポーネントを以前に追加されたコンポーネント(gridx、gridy)の隣に配置することを指定します。
static final int	REMAINDER	コンポーネントが列または行の最後のコンポーネントとなるように指定します。
static final int	SOUTH	コンポーネントをその表示領域の下端の左右中央に配置します。
static final int	SOUTHEAST	コンポーネントをその表示領域の右下隅に配置します。
static final int	SOUTHWEST	コンポーネントをその表示領域の左下隅に配置します。
static final int	VERTICAL	コンポーネントを垂直にサイズ変更し、水平にはサイズ変更しません。
double	weightx	余分の水平スペースを分配する方法を指定します。
double	weighty	垂直の余分なスペースを分配する方法を指定します。
static final 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

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

関連項目:

• 定数フィールド値

PAGE_START

public static final int PAGE_START

現在のComponentOrientationで、ページの先頭に関連付けられた表示領域のエッジに沿ってコンポーネントを中央に配置します。 水平方向でのNORTHと同等です。

関連項目:

• 定数フィールド値

PAGE_END

public static final int PAGE_END

現在のComponentOrientationで、ページの最後に関連付けられた表示領域のエッジに沿ってコンポーネントを中央に配置します。 水平方向でのSOUTHと同等です。

関連項目:

• 定数フィールド値

LINE_START

public static final int LINE_START

現在のComponentOrientationで、テキスト行が通常開始される表示領域のエッジに沿ってコンポーネントを中央に配置します。 水平方向の左から右向きを示すWEST、右から左向きを示すEASTと同等です。

関連項目:

• 定数フィールド値

LINE_END

public static final int LINE_END

現在のComponentOrientationで、テキスト行が通常終了する表示領域のエッジに沿ってコンポーネントを中央に配置します。 水平方向の左から右向きを示すWEST、右から左向きを示すEASTと同等です。

関連項目:

• 定数フィールド値

FIRST_LINE_START

public static final int FIRST_LINE_START

現在のComponentOrientationで、ページ上のテキストの最初の行が通常開始される表示領域のコーナーにコンポーネントを配置します。 水平方向の左から右向きを示すNORTHWEST、右から左向きを示すNORTHWESTと同等です。

関連項目:

• 定数フィールド値

FIRST_LINE_END

public static final int FIRST_LINE_END

現在のComponentOrientationで、ページ上のテキストの最初の行が通常終了する表示領域のコーナーにコンポーネントを配置します。 水平方向の左から右を示すNORTHWEST、右から左を示すNORTHWESTと同等です。

関連項目:

• 定数フィールド値

LAST_LINE_START

public static final int LAST_LINE_START

現在のComponentOrientationで、ページ上のテキストの最終行が通常開始される表示領域のコーナーにコンポーネントを配置します。 水平方向の左から右を示すSOUTHWEST、右から左を示すSOUTHWESTと同等です。

関連項目:

• 定数フィールド値

LAST_LINE_END

public static final int LAST_LINE_END

現在のComponentOrientationで、ページ上のテキストの最終行が通常終了する表示領域のコーナーにコンポーネントを配置します。 水平方向の左から右を示すSOUTHEAST、右から左を示すSOUTHEASTと同等です。

関連項目:

• 定数フィールド値

BASELINE

public static final int BASELINE

anchorフィールドが取り得る値。 コンポーネントが水平方向には中央揃えになり、垂直方向には支配行のベースラインにそろえられることを指定します。 コンポーネントにベースラインがない場合は、垂直方向に中央揃えされます。

導入されたバージョン:

1.6

関連項目:

• 定数フィールド値

BASELINE_LEADING

public static final int BASELINE_LEADING

anchorフィールドが取り得る値。 コンポーネントがリーディング・エッジに沿って水平方向に配置されることを指定します。 左から右方向のコンポーネントのリーディング・エッジは左端です。 垂直方向には、支配行のベースラインにそろえられます。 コンポーネントにベースラインがない場合は、垂直方向に中央揃えされます。

導入されたバージョン:

1.6

関連項目:

• 定数フィールド値

BASELINE_TRAILING

public static final int BASELINE_TRAILING

anchorフィールドが取り得る値。 コンポーネントがトレーリング・エッジに沿って水平方向に配置されることを指定します。 左から右方向のコンポーネントのトレーリング・エッジは右端です。 垂直方向には、支配行のベースラインにそろえられます。 コンポーネントにベースラインがない場合は、垂直方向に中央揃えされます。

導入されたバージョン:

1.6

関連項目:

• 定数フィールド値

ABOVE_BASELINE

public static final int ABOVE_BASELINE

anchorフィールドが取り得る値。 コンポーネントが水平方向に中央揃えされることを指定します。 垂直方向には、コンポーネントは下端が開始行のベースラインに接するように配置されます。 開始行にベースラインがない場合は、垂直方向に中央揃えされます。

導入されたバージョン:

1.6

関連項目:

• 定数フィールド値

ABOVE_BASELINE_LEADING

public static final int ABOVE_BASELINE_LEADING

anchorフィールドが取り得る値。 コンポーネントがリーディング・エッジに沿って水平方向に配置されることを指定します。 左から右方向のコンポーネントのリーディング・エッジは左端です。 垂直方向には、コンポーネントは下端が開始行のベースラインに接するように配置されます。 開始行にベースラインがない場合は、垂直方向に中央揃えされます。

導入されたバージョン:

1.6

関連項目:

• 定数フィールド値

ABOVE_BASELINE_TRAILING

public static final int ABOVE_BASELINE_TRAILING

anchorフィールドが取り得る値。 コンポーネントがトレーリング・エッジに沿って水平方向に配置されることを指定します。 左から右方向のコンポーネントのトレーリング・エッジは右端です。 垂直方向には、コンポーネントは下端が開始行のベースラインに接するように配置されます。 開始行にベースラインがない場合は、垂直方向に中央揃えされます。

導入されたバージョン:

1.6

関連項目:

• 定数フィールド値

BELOW_BASELINE

public static final int BELOW_BASELINE

anchorフィールドが取り得る値。 コンポーネントが水平方向に中央揃えされることを指定します。 垂直方向には、コンポーネントは上端が開始行のベースラインに接するように配置されます。 開始行にベースラインがない場合は、垂直方向に中央揃えされます。

導入されたバージョン:

1.6

関連項目:

• 定数フィールド値

BELOW_BASELINE_LEADING

public static final int BELOW_BASELINE_LEADING

anchorフィールドが取り得る値。 コンポーネントがリーディング・エッジに沿って水平方向に配置されることを指定します。 左から右方向のコンポーネントのリーディング・エッジは左端です。 垂直方向には、コンポーネントは上端が開始行のベースラインに接するように配置されます。 開始行にベースラインがない場合は、垂直方向に中央揃えされます。

導入されたバージョン:

1.6

関連項目:

• 定数フィールド値

BELOW_BASELINE_TRAILING

public static final int BELOW_BASELINE_TRAILING

anchorフィールドが取り得る値。 コンポーネントがトレーリング・エッジに沿って水平方向に配置されることを指定します。 左から右方向のコンポーネントのトレーリング・エッジは右端です。 垂直方向には、コンポーネントは上端が開始行のベースラインに接するように配置されます。 開始行にベースラインがない場合は、垂直方向に中央揃えされます。

導入されたバージョン:

1.6

関連項目:

• 定数フィールド値

gridx

public int gridx

コンポーネントの表示領域のリーディング・エッジを含むセルを指定します。ここで、行内の最初のセルにはgridx=0が割り当てられています。 コンポーネントの表示領域のリーディング・エッジは、水平方向に左から右方向のコンテナに対して左端、および水平方向に右から左方向のコンテナに対して右端になります。 値RELATIVEは、このコンポーネントを直前にコンテナに追加されたコンポーネントの直後に配置するように指定します。

デフォルト値はRELATIVEです。gridxは負の値にするべきではありません。

関連項目:

• clone()
• gridy
• ComponentOrientation

gridy

public int gridy

コンポーネントの表示領域のいちばん上にあるセルを指定します。ここで、いちばん上のセルにはgridy=0が割り当てられています。 値RELATIVEは、このコンポーネントを直前にコンテナに追加されたコンポーネントの真下に配置するように指定します。

デフォルト値はRELATIVEです。gridyは負の値にするべきではありません。

関連項目:

• clone()
• gridx

gridwidth

public int gridwidth

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

コンポーネントの表示領域がgridxから行の最後のセルまでであることを指定する場合は、REMAINDERを使用します。 コンポーネントの表示領域がgridxからその行の最後の1つ手前のセルまでであることを指定する場合は、RELATIVEを使用します。

gridwidthには負の値を指定することはできず、デフォルト値は1になります。

関連項目:

• clone()
• gridheight

gridheight

public int gridheight

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

コンポーネントの表示領域がgridyから列の最後のセルまでであることを指定する場合は、REMAINDERを使用します。 コンポーネントの表示領域がgridyからその列の最後の1つ手前のセルまでであることを指定する場合は、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

このフィールドはコンポーネントがその表示領域より小さい場合に使用されます。 これは表示領域内にコンポーネントを配置する場所を指定します。

方向相対値、ベースライン相対値および絶対値の3種類の値があります。 方向相対値は、コンテナのコンポーネントの方向プロパティを基準に解釈され、ベースライン相対値はベースラインを基準に解釈されます。絶対値の解釈はありません。 絶対値には次のものがあります。CENTER、NORTH、NORTHEAST、EAST、SOUTHEAST、SOUTH、SOUTHWEST、WEST、およびNORTHWEST。 方向相対値には次のものがあります。PAGE_START、PAGE_END、LINE_START、LINE_END、FIRST_LINE_START、FIRST_LINE_END、LAST_LINE_START、およびLAST_LINE_END。 ベースライン相対値は、BASELINE、BASELINE_LEADING、BASELINE_TRAILING、ABOVE_BASELINE、ABOVE_BASELINE_LEADING、ABOVE_BASELINE_TRAILING、BELOW_BASELINE、BELOW_BASELINE_LEADINGおよびBELOW_BASELINE_TRAILINGです。 デフォルト値はCENTERです。

関連項目:

• clone()
• ComponentOrientation

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ピクセルを足したものです。

デフォルト値は0です。

関連項目:

• clone()
• ipady

ipady

public int ipady

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

デフォルト値は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()

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

オーバーライド:

clone、クラスObject

戻り値:

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

関連項目:

• Cloneable