- java.lang.Object
-
- java.awt.GridBagConstraints
-
- すべての実装されたインタフェース:
Serializable
,Cloneable
public class GridBagConstraints extends Object implements Cloneable, Serializable
GridBagConstraints
クラスは、GridBagLayout
クラスを使用してレイアウトされるコンポーネントの制約を指定します。- 導入されたバージョン:
- 1.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
現在のComponentOrientation
で、ページ上のテキストの最初の行が通常終了する表示領域のコーナーにコンポーネントを配置します。static int
FIRST_LINE_START
現在のComponentOrientation
で、ページ上のテキストの最初の行が通常開始される表示領域のコーナーにコンポーネントを配置します。int
gridheight
コンポーネントの表示領域の1列のセル数を指定します。int
gridwidth
コンポーネントの表示領域の1行のセル数を指定します。int
gridx
コンポーネントの表示領域のリーディング・エッジを含むセルを指定します。ここで、行内の最初のセルにはgridx=0
が割り当てられています。int
gridy
コンポーネントの表示領域のいちばん上にあるセルを指定します。ここで、いちばん上のセルにはgridy=0
が割り当てられています。static int
HORIZONTAL
コンポーネントを水平にサイズ変更し、垂直にはサイズ変更しません。Insets
insets
コンポーネントの外側のパディング、つまりコンポーネントとその表示領域の端までの領域の最小値を指定します。int
ipadx
コンポーネントの内側のパディング、つまりコンポーネントの最小幅に追加する領域の値を指定します。int
ipady
コンポーネントの内側のパディング、つまりコンポーネントの最小の高さに追加する領域の値を指定します。static int
LAST_LINE_END
現在のComponentOrientation
で、ページ上のテキストの最終行が通常終了する表示領域のコーナーにコンポーネントを配置します。static int
LAST_LINE_START
現在のComponentOrientation
で、ページ上のテキストの最終行が通常開始される表示領域のコーナーにコンポーネントを配置します。static int
LINE_END
現在のComponentOrientation
で、テキスト行が通常終了する表示領域のエッジに沿ってコンポーネントを中央に配置します。static int
LINE_START
現在のComponentOrientation
で、テキスト行が通常開始される表示領域のエッジに沿ってコンポーネントを中央に配置します。static int
NONE
コンポーネントのサイズを変更しません。static int
NORTH
コンポーネントをその表示領域の上端の左右中央に配置します。static int
NORTHEAST
コンポーネントをその表示領域の右上隅に配置します。static int
NORTHWEST
コンポーネントをその表示領域の左上隅に配置します。static int
PAGE_END
現在のComponentOrientation
で、ページの最後に関連付けられた表示領域のエッジに沿ってコンポーネントを中央に配置します。static int
PAGE_START
現在のComponentOrientation
で、ページの先頭に関連付けられた表示領域のエッジに沿ってコンポーネントを中央に配置します。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
オブジェクトを作成します。
-
-
-
フィールドの詳細
-
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
は負の値にするべきではありません。
-
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になります。
-
weightx
public double weightx
余分の水平スペースを分配する方法を指定します。グリッド・バッグ・レイアウト・マネージャは、1列のウエイトが1列のすべてのコンポーネントの最大の
weightx
になるように計算します。 結果のレイアウトが塗りつぶす必要のある領域の幅より小さい場合、余分のスペースが各列のウエイトに比例して分配されます。 ウエイトがゼロの列には、余分のスペースは分配されません。すべてのウエイトがゼロの場合、すべての余分のスペースがセルのグリッドと左右両端の間に表示されます。
このフィールドのデフォルト値は
0
です。weightx
は負の値にするべきではありません。
-
weighty
public double weighty
垂直の余分なスペースを分配する方法を指定します。グリッド・バッグ・レイアウト・マネージャは、1行のウエイトが1行のすべてのコンポーネントの最大の
weighty
になるように計算します。 結果のレイアウトが塗りつぶす必要のある領域の高さより小さい場合、余分のスペースが各行のウエイトに比例して分配されます。 ウエイトがゼロの行には、余分のスペースは分配されません。すべてのウエイトがゼロの場合、すべての余分のスペースがセルのグリッドと上下の両端の間に表示されます。
このフィールドのデフォルト値は
0
です。weighty
は負の値にするべきではありません。
-
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
です。
-
-
コンストラクタの詳細
-
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
-
-