モジュール 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 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オブジェクトを作成します。

  • メソッドのサマリー

    修飾子と型 メソッド 説明
    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