java.awt
類別 GridBagConstraints

java.lang.Object
  java.awt.GridBagConstraints

所有已實作的介面：

Serializable, Cloneable

public class GridBagConstraints
extends Object
implements Cloneable, Serializable

GridBagConstraints 類別指定使用 GridBagLayout 類別佈置的元件的約束。

從以下版本開始：

JDK1.0

另請參見：

GridBagLayout, 序列化表格

欄位摘要

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 將元件置於顯示區域的一角，在該區域中，當前 ComponentOrienation 的頁面的第一個文本行正常結束。
static int	FIRST_LINE_START 將元件置於其顯示區域的一角，這一角的位置是頁面中最後一個文本行按照當前的 ComponentOrienation 在頁面中的開始位置。
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 將元件置於其顯示區域的一角，這一角的位置是頁面中最後一個文本行按照當前的 ComponentOrienation 在頁面中的結束位置。
static int	LAST_LINE_START 將元件置於其顯示區域的一角，這一角的位置是頁面中最後一個文本行按照當前的 ComponentOrienation 在頁面中的開始位置。
static int	LINE_END 沿顯示區域的邊緣居中放置元件，在該區域中，當前 ComponentOrienation 的文本行正常結束。
static int	LINE_START 沿顯示區域的邊緣居中放置元件，在該區域中，當前 ComponentOrienation 的文本行正常開始。
static int	NONE 不重新調整元件大小。
static int	NORTH 將元件置於其顯示區域的頂部，並在水平方向上居中。
static int	NORTHEAST 將元件置於其顯示區域的右上角。
static int	NORTHWEST 將元件置於其顯示區域的左上角。
static int	PAGE_END 沿顯示區域的邊緣居中放置元件，該顯示區域與當前 ComponentOrienation 的頁面結束部分相關。
static int	PAGE_START 沿顯示區域的邊緣居中放置元件，該顯示區域與當前 ComponentOrienation 的頁面開始部分相關。
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 將元件置於其顯示區域的左部，並在垂直方向上居中。

建構子摘要

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 物件，將其所有欄位都設置為傳入參數。

方法摘要

Object

clone() 創建此網格包約束（grid bag constraint）的副本。

從類別 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, 常數欄位值

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

沿顯示區域的邊緣居中放置元件，該顯示區域與當前 ComponentOrienation 的頁面開始部分相關。等同於水平方向的 NORTH。

另請參見：

常數欄位值

PAGE_END

public static final int PAGE_END

沿顯示區域的邊緣居中放置元件，該顯示區域與當前 ComponentOrienation 的頁面結束部分相關。等同於水平方向的 SOUTH。

另請參見：

常數欄位值

LINE_START

public static final int LINE_START

沿顯示區域的邊緣居中放置元件，在該區域中，當前 ComponentOrienation 的文本行正常開始。等同於水平的、從左到右方向的 WEST，以及水平的、從右到左方向的 EAST。

另請參見：

常數欄位值

LINE_END

public static final int LINE_END

沿顯示區域的邊緣居中放置元件，在該區域中，當前 ComponentOrienation 的文本行正常結束。等同於水平的、從左到右方向的 EAST，以及水平的、從右到左方向的 WEST。

另請參見：

常數欄位值

FIRST_LINE_START

public static final int FIRST_LINE_START

將元件置於其顯示區域的一角，這一角的位置是頁面中最後一個文本行按照當前的 ComponentOrienation 在頁面中的開始位置。等同於水平的、從左到右方向的 NORTHWEST，以及水平的、從右到左方向的 NORTHEAST。

另請參見：

常數欄位值

FIRST_LINE_END

public static final int FIRST_LINE_END

將元件置於顯示區域的一角，在該區域中，當前 ComponentOrienation 的頁面的第一個文本行正常結束。等同於水平的、從左到右方向的 NORTHEAST，以及水平的、從右到左方向的 NORTHWEST。

另請參見：

常數欄位值

LAST_LINE_START

public static final int LAST_LINE_START

將元件置於其顯示區域的一角，這一角的位置是頁面中最後一個文本行按照當前的 ComponentOrienation 在頁面中的開始位置。等同於水平的、從左到右的 SOUTHWEST，以及水平的、從右到左方向的 SOUTHEAST。

另請參見：

常數欄位值

LAST_LINE_END

public static final int LAST_LINE_END

將元件置於其顯示區域的一角，這一角的位置是頁面中最後一個文本行按照當前的 ComponentOrienation 在頁面中的結束位置。等同於水平的、從左到右的 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(), 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 - 初始 gridwidth 值。

gridheight - 初始 gridheight 值。

weightx - 初始 weightx 值。

weighty - 初始 weighty 值。

anchor - 初始 anchor 值。

fill - 初始 fill 值。

insets - 初始 insets 值。

ipadx - 初始 ipadx 值。

ipady - 初始 ipady 值。

從以下版本開始：

1.2

另請參見：

gridx, gridy, gridwidth, gridheight, weightx, weighty, anchor, fill, insets, ipadx, ipady

方法詳細資訊

clone

public Object clone()

創建此網格包約束（grid bag constraint）的副本。

覆寫：

類別 Object 中的 clone

返回：

此網格包約束的副本

另請參見：

Cloneable