模块  java.desktop
软件包  java.awt

Class GridBagConstraints

    • 字段汇总

      字段  
      变量和类型 字段 描述
      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
      指定组件显示区域的列中的单元格数。
      int gridwidth
      指定组件显示区域的行中单元格数。
      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
      指定此组件是下一个到最后一个组件在其行或列( gridwidthgridheight ),或者该组分被旁边的以前添加的组件(放置 gridxgridy )。
      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
        指定此组件是下一个到最后一个组件在其行或列( gridwidthgridheight ),或者该组分被旁边的以前添加的组件(放置 gridxgridy )。
        另请参见:
        gridwidthgridheightgridxgridy常数字段值
      • 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的页面末尾相关联。 水平方向等于南方。
        另请参见:
        常数字段值
      • 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指定将组件紧跟在添加此组件之前添加到容器的组件之后。

        默认值为RELATIVE gridx应该是非负值。

        另请参见:
        clone()gridyComponentOrientation
      • gridy

        public int gridy
        指定组件显示区域顶部的单元格,其中最顶层的单元格为gridy=0 RELATIVE指定将组件放置在添加此组件之前添加到容器的组件的正下方。

        默认值为RELATIVE gridy应该是非负值。

        另请参见:
        clone()gridx
      • gridwidth

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

        使用REMAINDER指定组件的显示区域将从gridx到行中的最后一个单元格。 使用RELATIVE指定组件的显示区域将从gridx到其行中最后一个的下一个。

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

        另请参见:
        clone()gridheight
      • gridheight

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

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

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

        另请参见:
        clone()gridwidth
      • weightx

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

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

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

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

        另请参见:
        clone()weighty
      • weighty

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

        网格包布局管理器计算行的权重为一行中所有组件的最大值weighty 如果得到的布局垂直小于它需要填充的区域,则额外的空间按其重量分配到每一行。 权重为零的行不会获得额外空间。

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

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

        另请参见:
        clone()weightx
      • 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_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 - 初始网格值。
        gridwidth - 初始 gridwidth值。
        gridheight - 初始 gridheight值。
        weightx - 初始 weightx值。
        weighty - 初始重量值。
        anchor - 初始锚值。
        fill - 初始填充值。
        insets - 初始insets值。
        ipadx - 初始ipadx值。
        ipady - 初始ipady值。
        从以下版本开始:
        1.2
        另请参见:
        gridxgridygridwidthgridheightweightxweightyanchorfillinsetsipadxipady
    • 方法详细信息

      • clone

        public Object clone()
        创建此网格包约束的副本。
        重写:
        clone在课程 Object
        结果
        此网格包约束的副本
        另请参见:
        Cloneable