模块 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
参见:
  • 字段摘要

    字段
    修饰符和类型
    Field
    描述
    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
    将组件放在其显示区域的左侧,垂直居中。
  • 构造方法总结

    构造方法
    构造方法
    描述
    创建一个 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 对象,其所有字段都设置为传入的参数。
  • 方法总结

    修饰符和类型
    方法
    描述
    创建此网格包约束的副本。

    在类 java.lang.Object 中声明的方法

    equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • 字段详细信息

    • 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。

      参见:
  • 构造方法详细信息

    • 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 - 初始网格值。
      gridwidth - 初始网格宽度值。
      gridheight - 初始网格高度值。
      weightx - 初始 weightx 值。
      weighty - 初始权重值。
      anchor - 初始锚值。
      fill - 初始填充值。
      insets - 初始插入值。
      ipadx - 初始 ipadx 值。
      ipady - 初始 ipady 值。
      自从:
      1.2
      参见:
  • 方法详情

    • clone

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