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类零件的约束。

从以下版本开始：

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`其显示区域的边缘。
`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` 将组件放在其显示区域的左侧，垂直居中。

构造方法摘要

构造方法
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

- Field Detail
  - 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一页的开始相关的显示区域的边缘。等于北水平方向。
    
    另请参见：
    
    Constant Field Values
  - PAGE_END
```
public static final int PAGE_END
```
    放置组件中心随着最后一页有关当前 ComponentOrientation其显示区域的边缘，相当于水平方向南。
    
    另请参见：
    
    Constant Field Values
  - LINE_START
```
public static final int LINE_START
```
    放置组件为中心沿其显示区域的文本行通常为当前 ComponentOrientation开始。等于西部水平，左到右的方向和东部为水平，右到左的方向。
    
    另请参见：
    
    Constant Field Values
  - LINE_END
```
public static final int LINE_END
```
    放置组件为中心沿其显示区域的文字通常会结束当前的 ComponentOrientation。等于东横，左为右水平方向和西、左方向右。
    
    另请参见：
    
    Constant Field Values
  - FIRST_LINE_START
```
public static final int FIRST_LINE_START
```
    放置组件在角落的显示区域，页面文字的第一行通常为当前 ComponentOrientation开始。等于西北水平，左至右方向和东北为水平，右到左的方向。
    
    另请参见：
    
    Constant Field Values
  - FIRST_LINE_END
```
public static final int FIRST_LINE_END
```
    放置组件在角落的显示区域，页面文字的第一行通常会结束当前的 ComponentOrientation。东北水平，左至右方向，西北为水平，右至左的方向。
    
    另请参见：
    
    Constant Field Values
  - LAST_LINE_START
```
public static final int LAST_LINE_START
```
    放置组件在角落的显示区域在页的最后一行文字通常会开始为当前 ComponentOrientation。等于西南水平，左至右方向和东南为水平，右到左的方向。
    
    另请参见：
    
    Constant Field Values
  - LAST_LINE_END
```
public static final int LAST_LINE_END
```
    放置组件在角落的显示区域在页的最后一行文字通常会结束当前的 ComponentOrientation。东南为水平，左至右的方向和西南为水平，右到左的方向。
    
    另请参见：
    
    Constant Field Values
  - BASELINE
```
public static final int BASELINE
```
    为 anchor场可能值。指定组件应水平居中，并沿现行行的基线垂直对齐。如果组件没有基线，它将垂直居中。
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    Constant Field Values
  - BASELINE_LEADING
```
public static final int BASELINE_LEADING
```
    为 anchor场可能值。指定该组件应水平放置在前缘上。对于一个左到右方向的组件，领先的边缘是左边缘。垂直的组件沿着当前行的基线对齐。如果组件没有基线，它将垂直居中。
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    Constant Field Values
  - BASELINE_TRAILING
```
public static final int BASELINE_TRAILING
```
    为 anchor场可能值。指定该组件应水平放置在后缘上。对于一个左到右方向的组件，尾随的边缘是右边缘。垂直的组件沿着当前行的基线对齐。如果组件没有基线，它将垂直居中。
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    Constant Field Values
  - ABOVE_BASELINE
```
public static final int ABOVE_BASELINE
```
    为 anchor场可能值。指定组件应以水平为中心的。垂直的组件被定位，使其底部边缘接触到起始行的基线。如果起始行没有基线，则将垂直居中。
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    Constant Field Values
  - ABOVE_BASELINE_LEADING
```
public static final int ABOVE_BASELINE_LEADING
```
    为 anchor场可能值。指定该组件应水平放置在前缘上。对于一个左到右方向的组件，领先的边缘是左边缘。垂直的组件被定位，使其底部边缘接触到起始行的基线。如果起始行没有基线，则将垂直居中。
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    Constant Field Values
  - ABOVE_BASELINE_TRAILING
```
public static final int ABOVE_BASELINE_TRAILING
```
    为 anchor场可能值。指定该组件应水平放置在后缘上。对于一个左到右方向的组件，尾随的边缘是右边缘。垂直的组件被定位，使其底部边缘接触到起始行的基线。如果起始行没有基线，则将垂直居中。
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    Constant Field Values
  - BELOW_BASELINE
```
public static final int BELOW_BASELINE
```
    为 anchor场可能值。指定组件应以水平为中心的。垂直的组件被定位，使其顶部边缘接触到起始行的基线。如果起始行没有基线，则将垂直居中。
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    Constant Field Values
  - BELOW_BASELINE_LEADING
```
public static final int BELOW_BASELINE_LEADING
```
    为 anchor场可能值。指定该组件应水平放置在前缘上。对于一个左到右方向的组件，领先的边缘是左边缘。垂直的组件被定位，使其顶部边缘接触到起始行的基线。如果起始行没有基线，则将垂直居中。
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    Constant Field Values
  - BELOW_BASELINE_TRAILING
```
public static final int BELOW_BASELINE_TRAILING
```
    为 anchor场可能值。指定该组件应水平放置在后缘上。对于一个左到右方向的组件，尾随的边缘是右边缘。垂直的组件被定位，使其顶部边缘接触到起始行的基线。如果起始行没有基线，则将垂直居中。
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    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
- Constructor Detail
  - 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 -初始插入值。
    
    ipadx -初始ipadx价值。
    
    ipady -初始iPady价值。
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    gridx， gridy， gridwidth， gridheight， weightx， weighty， anchor， fill， insets， ipadx， ipady
- 方法详细信息
  - clone
```
public Object clone()
```
    创建这个网格包约束的副本。
    
    重写：
    
    clone 方法重写，继承类 Object
    
    结果
    
    这个网格袋约束的副本
    
    另请参见：
    
    Cloneable

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class GridBagConstraints

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Field Detail

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

Constructor Detail

GridBagConstraints

GridBagConstraints

方法详细信息

clone