GridBagConstraints (Java Platform SE 8 )

java.lang.Object
- java.awt.GridBagConstraints

All Implemented Interfaces:

Serializable ， Cloneable
```
public class GridBagConstraints
extends Object
implements Cloneable, Serializable
```
GridBagConstraints类为使用 GridBagLayout类布局的 GridBagLayout了 GridBagLayout 。

从以下版本开始：

JDK1.0

另请参见：

GridBagLayout ， Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`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`的页面末尾相关联的显示区域的边缘 `ComponentOrientation` 。
`static int`	`PAGE_START` 将组件沿着与当前 `ComponentOrientation`的页面开头相关联的显示区域的边缘 `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` 将组件放置在其显示区域的左侧，垂直居中。

构造方法摘要

构造方法
Constructor and Description
`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`对象，其所有字段都设置为传入参数。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`Object`	`clone()` 创建此网格包约束的副本。

Methods inherited from class 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 ， Constant Field Values
  - REMAINDER
```
public static final int REMAINDER
```
    指定此组件是其列或行中的最后一个组件。
    
    另请参见：
    
    Constant Field Values
  - NONE
```
public static final int NONE
```
    不要调整组件的大小。
    
    另请参见：
    
    Constant Field Values
  - BOTH
```
public static final int BOTH
```
    水平和垂直调整组件的大小。
    
    另请参见：
    
    Constant Field Values
  - HORIZONTAL
```
public static final int HORIZONTAL
```
    调整组件水平但不垂直。
    
    另请参见：
    
    Constant Field Values
  - VERTICAL
```
public static final int VERTICAL
```
    垂直调整组件大小但不水平调整。
    
    另请参见：
    
    Constant Field Values
  - CENTER
```
public static final int CENTER
```
    将组件放在其显示区域的中央。
    
    另请参见：
    
    Constant Field Values
  - NORTH
```
public static final int NORTH
```
    将组件放置在其显示区域的顶部，水平居中。
    
    另请参见：
    
    Constant Field Values
  - NORTHEAST
```
public static final int NORTHEAST
```
    将组件放在其显示区域的右上角。
    
    另请参见：
    
    Constant Field Values
  - EAST
```
public static final int EAST
```
    将组件放置在显示区域的右侧，垂直居中。
    
    另请参见：
    
    Constant Field Values
  - SOUTHEAST
```
public static final int SOUTHEAST
```
    将组件放在其显示区域的右下角。
    
    另请参见：
    
    Constant Field Values
  - SOUTH
```
public static final int SOUTH
```
    将组件放在其显示区域的底部，水平居中。
    
    另请参见：
    
    Constant Field Values
  - SOUTHWEST
```
public static final int SOUTHWEST
```
    将组件放在其显示区域的左下角。
    
    另请参见：
    
    Constant Field Values
  - WEST
```
public static final int WEST
```
    将组件放置在其显示区域的左侧，垂直居中。
    
    另请参见：
    
    Constant Field Values
  - NORTHWEST
```
public static final int NORTHWEST
```
    将组件放在其显示区域的左上角。
    
    另请参见：
    
    Constant Field Values
  - PAGE_START
```
public static final int PAGE_START
```
    将组件沿着与当前ComponentOrientation的页面开头相关联的显示区域的边缘ComponentOrientation 。等于NORTH用于水平方向。
    
    另请参见：
    
    Constant Field Values
  - PAGE_END
```
public static final int PAGE_END
```
    将组件沿着与当前ComponentOrientation的页面末尾相关联的显示区域的边缘ComponentOrientation 。相当于SOUTH的水平方向。
    
    另请参见：
    
    Constant Field Values
  - LINE_START
```
public static final int LINE_START
```
    将组件沿着其显示区域的边缘放置，其中文本行通常将为当前的ComponentOrientation开始。水平，从左到右的方向相当于WEST，水平，从右到左的方向为EAST。
    
    另请参见：
    
    Constant Field Values
  - LINE_END
```
public static final int LINE_END
```
    将组件沿其显示区域的边缘放置，其中文本行正常结束当前的ComponentOrientation 。相对于横向，左至右方向的EAST，水平，从右到左的方向为WEST。
    
    另请参见：
    
    Constant Field Values
  - FIRST_LINE_START
```
public static final int FIRST_LINE_START
```
    将组件放置在其显示区域的一角，其中页面上的第一行文本通常将为当前的ComponentOrientation开始。相对于NORTHWEST，水平，从左到右的方向和NORTHEAST的水平，从右到左的方向。
    
    另请参见：
    
    Constant Field Values
  - FIRST_LINE_END
```
public static final int FIRST_LINE_END
```
    将组件放置在其显示区域的一角，其中页面上的第一行文本正常结束当前的ComponentOrientation 。相对于NORTHEAST为水平，从左到右的方向，NORTHWEST为水平，从右到左的方向。
    
    另请参见：
    
    Constant Field Values
  - LAST_LINE_START
```
public static final int LAST_LINE_START
```
    将组件放置在其显示区域的一角，其中页面上的最后一行文本通常将为当前的ComponentOrientation启动。相对于SOUTHWEST的水平，从左到右的方向和SOUTHEAST的水平，从右到左的方向。
    
    另请参见：
    
    Constant Field Values
  - LAST_LINE_END
```
public static final int LAST_LINE_END
```
    将组件放置在其显示区域的一角，其中页面上的最后一行文本正常结束当前的ComponentOrientation 。相当于SOUTHEAST的水平，从左到右的方向和SOUTHWEST的水平，从右到左的方向。
    
    另请参见：
    
    Constant Field Values
  - BASELINE
```
public static final int BASELINE
```
    可能的值为anchor字段。指定组件应沿着主要行的基准水平居中并垂直对齐。如果组件没有基线，它将垂直居中。
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    Constant Field Values
  - BASELINE_LEADING
```
public static final int BASELINE_LEADING
```
    可能的值为anchor字段。指定组件应沿着前沿水平放置。对于具有从左到右方向的组件，前缘是左边缘。垂直地，组件沿着主要行的基线对齐。如果组件没有基线，它将垂直居中。
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    Constant Field Values
  - BASELINE_TRAILING
```
public static final int BASELINE_TRAILING
```
    可能的值为anchor字段。指定组件应沿着后沿水平放置。对于具有从左到右方向的组件，后缘是右边缘。垂直地，组件沿着主要行的基线对齐。如果组件没有基线，它将垂直居中。
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    Constant Field Values
  - ABOVE_BASELINE
```
public static final int ABOVE_BASELINE
```
    可能的值为anchor字段。指定组件应该水平居中。垂直地将组件定位成使其底部边缘接触起始行的基线。如果起始行没有基线，它将垂直居中。
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    Constant Field Values
  - ABOVE_BASELINE_LEADING
```
public static final int ABOVE_BASELINE_LEADING
```
    可能的值为anchor字段。指定组件应沿着前沿水平放置。对于具有从左到右方向的组件，前缘是左边缘。垂直地将组件定位成使其底部边缘接触起始行的基线。如果起始行没有基线，它将垂直居中。
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    Constant Field Values
  - ABOVE_BASELINE_TRAILING
```
public static final int ABOVE_BASELINE_TRAILING
```
    可能的值为anchor字段。指定组件应沿着后沿水平放置。对于具有从左到右方向的组件，后缘是右边缘。垂直地将组件定位成使其底部边缘接触起始行的基线。如果起始行没有基线，它将垂直居中。
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    Constant Field Values
  - BELOW_BASELINE
```
public static final int BELOW_BASELINE
```
    可能的值为anchor字段。指定组件应该水平居中。垂直地将组件定位成使其顶部边缘接触起始行的基线。如果起始行没有基线，它将垂直居中。
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    Constant Field Values
  - BELOW_BASELINE_LEADING
```
public static final int BELOW_BASELINE_LEADING
```
    可能的值为anchor字段。指定组件应沿着前沿水平放置。对于具有从左到右方向的组件，前缘是左边缘。垂直地将组件定位成使其顶部边缘接触起始行的基线。如果起始行没有基线，它将垂直居中。
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    Constant Field Values
  - BELOW_BASELINE_TRAILING
```
public static final int BELOW_BASELINE_TRAILING
```
    可能的值为anchor字段。指定组件应沿着后沿水平放置。对于具有从左到右方向的组件，后缘是右边缘。垂直地将组件定位成使其顶部边缘接触起始行的基线。如果起始行没有基线，它将垂直居中。
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    Constant Field Values
  - 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
```
    指定组件显示区域的一行中的单元格数。
    使用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
```
    当该组件小于其显示区域时使用该字段。它确定在显示区域内放置组件的位置。
    有三种可能的值：取向相对，基线相对和绝对值。方向相对值相对于容器的组件方向属性来解释，基线相对值相对于基线解释，绝对值不是。该绝对值为： 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 - 初始网格宽度值。
    
    gridheight - 初始gridheight值。
    
    weightx - 初始weightx值。
    
    weighty - 初始重量值。
    
    anchor - 初始锚值。
    
    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

Class GridBagConstraints

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

字段详细信息

RELATIVE

REMAINDER

NONE

BOTH

HORIZONTAL

VERTICAL

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

gridx

gridy

gridwidth

gridheight

weightx

weighty

anchor

fill

insets

ipadx

ipady

构造方法详细信息

GridBagConstraints

GridBagConstraints

方法详细信息

clone