JavaTM Platform
Standard Ed. 6

java.awt
クラス GridBagConstraints

java.lang.Object
  上位を拡張 java.awt.GridBagConstraints
すべての実装されたインタフェース:
Serializable, Cloneable

public class GridBagConstraints
extends Object
implements Cloneable, Serializable

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

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

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

関連項目:
定数フィールド値

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
現在の ComponentOrienation で、ページの開始位置に関連付けられた表示領域のエッジに沿ってコンポーネントを中央に配置します。水平方向での NORTH と同等です。

関連項目:
定数フィールド値

PAGE_END

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

関連項目:
定数フィールド値

LINE_START

public static final int LINE_START
現在の ComponentOrienation で、一般的なテキスト行が始まる表示領域のエッジに沿ってコンポーネントを中央に配置します。水平方向の左から右向きを示す WEST、右から左向きを示す EAST と同等です。

関連項目:
定数フィールド値

LINE_END

public static final int LINE_END
現在の ComponentOrienation で、一般的なテキスト行が始まる表示領域のエッジに沿ってコンポーネントを中央に配置します。水平方向の左から右向きを示す WEST、右から左向きを示す EAST と同等です。

関連項目:
定数フィールド値

FIRST_LINE_START

public static final int FIRST_LINE_START
現在の ComponentOrienation で、ページの最初の一般的なテキスト行が始まる表示領域のコーナーにコンポーネントを配置します。水平方向の左から右向きを示す NORTHWEST、右から左向きを示す NORTHWEST と同等です。

関連項目:
定数フィールド値

FIRST_LINE_END

public static final int FIRST_LINE_END
現在の ComponentOrienation で、ページの最初の一般的なテキスト行が終了する表示領域のコーナーにコンポーネントを配置します。水平方向の左から右を示す NORTHWEST、右から左を示す NORTHWEST と同等です。

関連項目:
定数フィールド値

LAST_LINE_START

public static final int LAST_LINE_START
現在の ComponentOrienation で、ページの最後の一般的なテキスト行が始まる表示領域のコーナーにコンポーネントを配置します。水平方向の左から右を示す SOUTHWEST、右から左を示す SOUTHWEST と同等です。

関連項目:
定数フィールド値

LAST_LINE_END

public static final int LAST_LINE_END
現在の ComponentOrienation で、ページの最後の一般的なテキスト行が終了する表示領域のコーナーにコンポーネントを配置します。水平方向の左から右を示す 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 行のセル数を指定します。

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

gridwidth には負の値を指定することはできません。デフォルト値は 1 です。

関連項目:
clone(), gridheight

gridheight

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

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

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 種類の値があります。方向相対値は、コンテナのコンポーネントの方向プロパティーを基準に解釈され、ベースライン相対値はベースラインを基準に解釈されます。絶対値の解釈はありません。絶対値には次のものがあります。CENTERNORTHNORTHEASTEASTSOUTHEASTSOUTHSOUTHWESTWEST、および NORTHWEST です。方向相対値には次のものがあります。PAGE_STARTPAGE_ENDLINE_STARTLINE_ENDFIRST_LINE_STARTFIRST_LINE_ENDLAST_LINE_START、および LAST_LINE_END です。ベースライン相対値には次のものがあります。BASELINEBASELINE_LEADINGBASELINE_TRAILINGABOVE_BASELINEABOVE_BASELINE_LEADINGABOVE_BASELINE_TRAILINGBELOW_BASELINEBELOW_BASELINE_LEADING、および BELOW_BASELINE_TRAILING です。デフォルト値は CENTER です。

関連項目:
clone(), ComponentOrientation

fill

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

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

デフォルト値は 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()
このグリッドバッグ制約のコピーを作成します。

オーバーライド:
クラス Object 内の clone
戻り値:
このグリッドバッグ制約のコピー
関連項目:
Cloneable

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。