Module java.desktop
Package java.awt

Class GridBagConstraints

java.lang.Object
java.awt.GridBagConstraints
所有已实现的接口:
Serializable, Cloneable

public class GridBagConstraints extends Object implements Cloneable, Serializable
GridBagConstraints类指定使用GridBagLayout类布局的组件的约束条件。
自从:
1.0
参见:
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final int
    anchor字段的可能值。
    static final int
    anchor字段的可能值。
    static final int
    anchor字段的可能值。
    int
    当组件小于其显示区域时使用此字段。
    static final int
    anchor字段的可能值。
    static final int
    anchor字段的可能值。
    static final int
    anchor字段的可能值。
    static final int
    anchor字段的可能值。
    static final int
    anchor字段的可能值。
    static final int
    anchor字段的可能值。
    static final int
    水平和垂直同时调整组件大小。
    static final int
    将组件放置在其显示区域的中心。
    static final int
    将组件放置在其显示区域的右侧,垂直居中。
    int
    当组件的显示区域大于组件请求的大小时使用此字段。
    static final int
    将组件放置在其显示区域的角落,其中页面上的第一行通常会结束,适用于当前的ComponentOrientation
    static final int
    将组件放置在其显示区域的角落,其中页面上的第一行通常会开始,适用于当前的ComponentOrientation
    int
    指定组件显示区域中一列的单元格数。
    int
    指定组件显示区域中一行的单元格数。
    int
    指定包含组件显示区域前沿的单元格,其中一行中的第一个单元格具有gridx=0
    int
    指定位于组件显示区域顶部的单元格,其中最顶部的单元格具有gridy=0
    static final int
    仅水平调整组件大小,不垂直调整。
    此字段指定组件的外部填充,即组件与其显示区域边缘之间的最小间距。
    int
    此字段指定组件的内部填充,即要添加到组件最小宽度的空间量。
    int
    此字段指定内部填充,即要添加到组件最小高度的空间量。
    static final int
    将组件放置在其显示区域的角落,其中页面上的最后一行通常会结束,适用于当前的ComponentOrientation
    static final int
    将组件放置在其显示区域的角落,其中页面上的最后一行通常会开始,适用于当前的ComponentOrientation
    static final int
    将组件沿着与当前ComponentOrientation的页面结束相关联的显示区域边缘居中。
    static final int
    将组件沿着与当前ComponentOrientation的页面开始相关联的显示区域边缘居中。
    static final int
    不调整组件大小。
    static final int
    将组件放置在其显示区域的顶部,水平居中。
    static final int
    将组件放置在其显示区域的右上角。
    static final int
    将组件放置在其显示区域的左上角。
    static final int
    将组件沿着与当前ComponentOrientation的页面结束相关联的显示区域边缘居中。
    static final int
    将组件沿着与当前ComponentOrientation的页面开始相关联的显示区域边缘居中。
    static final int
    指定此组件是其列或行中倒数第二个组件(gridwidthgridheight),或将此组件放置在先前添加的组件旁边(gridxgridy)。
    static final int
    指定此组件是其列或行中的最后一个组件。
    static final int
    将组件放置在其显示区域的底部,水平居中。
    static final int
    将组件放置在其显示区域的右下角。
    static final int
    将组件放置在其显示区域的左下角。
    static final int
    仅垂直调整组件大小,不水平调整。
    double
    指定如何分配额外的水平空间。
    double
    指定如何分配额外的垂直空间。
    static final int
    将组件放置在其显示区域的左侧,垂直居中。
  • Constructor Summary

    Constructors
    Constructor
    Description
    创建一个所有字段都设置为默认值的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对象。
  • Method Summary

    Modifier and Type
    Method
    Description
    clone()
    创建此网格包约束的副本。

    Methods declared in class java.lang.Object

    equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Field Details

    • RELATIVE

      public static final int RELATIVE
      指定此组件是其列或行中倒数第二个组件(gridwidthgridheight),或将此组件放置在先前添加的组件旁边(gridxgridy)。
      参见:
    • 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文本行通常结束的显示区域边缘的中心位置。对于水平方向,从左到右的布局等同于EAST,从右到左的布局等同于WEST。
      参见:
    • FIRST_LINE_START

      public static final int FIRST_LINE_START
      将组件放置在与当前ComponentOrientation页面上第一行文本通常开始的显示区域角落。对于水平方向,从左到右的布局等同于NORTHWEST,从右到左的布局等同于NORTHEAST。
      参见:
    • FIRST_LINE_END

      public static final int FIRST_LINE_END
      将组件放置在与当前ComponentOrientation页面上第一行文本通常结束的显示区域角落。对于水平方向,从左到右的布局等同于NORTHEAST,从右到左的布局等同于NORTHWEST。
      参见:
    • LAST_LINE_START

      public static final int LAST_LINE_START
      将组件放置在与当前ComponentOrientation页面上最后一行文本通常开始的显示区域角落。对于水平方向,从左到右的布局等同于SOUTHWEST,从右到左的布局等同于SOUTHEAST。
      参见:
    • LAST_LINE_END

      public static final int LAST_LINE_END
      将组件放置在与当前ComponentOrientation页面上最后一行文本通常结束的显示区域角落。对于水平方向,从左到右的布局等同于SOUTHEAST,从右到左的布局等同于SOUTHWEST。
      参见:
    • 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指定组件应立即放置在刚刚添加到容器中的组件之后。

      默认值为RELATIVEgridx应为非负值。

      参见:
    • gridy

      public int gridy
      指定组件显示区域顶部的单元格,其中最顶部的单元格具有gridy=0。值RELATIVE指定组件应放置在刚刚添加到容器中的组件的下方。

      默认值为RELATIVEgridy应为非负值。

      参见:
    • gridwidth

      public int gridwidth
      指定组件显示区域中一行的单元格数。

      使用REMAINDER指定组件的显示区域从gridx到该行的最后一个单元格。使用RELATIVE指定组件的显示区域从gridx到该行的倒数第二个单元格。

      gridwidth应为非负值,默认值为1。

      参见:
    • gridheight

      public int gridheight
      指定组件显示区域中一列中的单元格数。

      使用REMAINDER指定组件的显示区域将从gridy到该列的最后一个单元格。使用RELATIVE指定组件的显示区域将从gridy到其列中的倒数第二个单元格。

      gridheight应为非负值,默认值为1。

      参见:
    • weightx

      public double weightx
      指定如何分配额外的水平空间。

      网格包布局管理器计算一列的权重为该列中所有组件的最大weightx。如果生成的布局在水平方向上比需要填充的区域小,则额外空间按比例分配给每一列的权重。权重为零的列不会接收额外空间。

      如果所有权重都为零,则所有额外空间将出现在单元格的网格之间以及左右边缘之间。

      此字段的默认值为0weightx应为非负值。

      参见:
    • weighty

      public double weighty
      指定如何分配额外的垂直空间。

      网格包布局管理器计算一行的权重为该行中所有组件的最大weighty。如果生成的布局在垂直方向上比需要填充的区域小,则额外空间按比例分配给每一行的权重。权重为零的行不会接收额外空间。

      如果所有权重都为零,则所有额外空间将出现在单元格的网格之间以及顶部和底部边缘之间。

      此字段的默认值为0weighty应为非负值。

      参见:
    • anchor

      public int anchor
      当组件小于其显示区域时使用此字段,它确定在显示区域内的位置。

      有三种可能的值:方向相对值、基线相对值和绝对值。方向相对值相对于容器的组件方向属性进行解释,基线相对值相对于基线进行解释,绝对值不进行解释。绝对值包括:CENTERNORTHNORTHEASTEASTSOUTHEASTSOUTHSOUTHWESTWESTNORTHWEST。方向相对值包括:PAGE_STARTPAGE_ENDLINE_STARTLINE_ENDFIRST_LINE_STARTFIRST_LINE_ENDLAST_LINE_STARTLAST_LINE_END。基线相对值包括:BASELINEBASELINE_LEADINGBASELINE_TRAILINGABOVE_BASELINEABOVE_BASELINE_LEADINGABOVE_BASELINE_TRAILINGBELOW_BASELINEBELOW_BASELINE_LEADINGBELOW_BASELINE_TRAILING。默认值为CENTER

      参见:
    • fill

      public int fill
      当组件的显示区域大于组件请求的大小时使用此字段,它确定是否调整组件的大小,以及如何调整。

      fill的有效值如下:

      • NONE:不调整组件的大小。
      • HORIZONTAL:使组件足够宽以水平填充其显示区域,但不更改其高度。
      • VERTICAL:使组件足够高以垂直填充其显示区域,但不更改其宽度。
      • BOTH:使组件完全填充其显示区域。

      默认值为NONE

      参见:
    • insets

      public Insets insets
      此字段指定组件的外部填充,即组件与其显示区域边缘之间的最小间距。

      默认值为new Insets(0, 0, 0, 0)

      参见:
    • ipadx

      public int ipadx
      此字段指定组件的内部填充,即要添加到组件最小宽度的空间量。组件的宽度至少为其最小宽度加上ipadx像素。

      默认值为0

      参见:
    • ipady

      public int ipady
      此字段指定内部填充,即要添加到组件最小高度的空间量。组件的高度至少为其最小高度加上ipady像素。

      默认值为0。

      参见:
  • Constructor Details

    • 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
      参见:
  • Method Details

    • clone

      public Object clone()
      创建此网格包约束的副本。
      覆盖:
      clone 在类 Object
      返回:
      此网格包约束的副本
      参见: