javax.swing
類別 SpringLayout.Constraints

java.lang.Object
  javax.swing.SpringLayout.Constraints

正在封閉類別：

SpringLayout

public static class SpringLayout.Constraints
extends Object

Constraints 物件將管理元件大小和位置更改方式的約束存儲在 SpringLayout 控制的容器中。由於 Constraints 物件具有 x、y、width 和 height 屬性，因而它類似於一個 Rectangle。但是，在 Constraints 物件中，這些屬性具有的是 Spring 值，而不是整數。此外，可以使用 constraint 屬性按四個邊（東、南、西、北）操作一個 Constraints 物件。

對於 Constraints 物件，以下公式始終為 true（這裡 WEST 和 x 同義，同樣地 NORTH 和 y 同義）：

               EAST = WEST + WIDTH
              SOUTH = NORTH + HEIGHT
  HORIZONTAL_CENTER = WEST + WIDTH/2
    VERTICAL_CENTER = NORTH + HEIGHT/2
  ABSOLUTE_BASELINE = NORTH + RELATIVE_BASELINE*
 

例如，如果指定 WIDTH 和 WEST (X) 位置，則 EAST 按 WEST + WIDTH 計算。如果指定 WIDTH 和 EAST 位置，則 WEST (X) 位置按 EAST - WIDTH 計算。

[RELATIVE_BASELINE 是調用 SpringLayout.Constraints(Component) 時或向 SpringLayout 物件註冊約束物件時自動設置的專有約束]。

註：在本文檔中，操作符表示該 Spring 類別中的方法。例如，"a + b" 等於 Spring.sum(a, b)，"a - b" 等於 Spring.sum(a, Spring.minus(b))。有關 spring 演算法的更多詳細資訊，請參閱 Spring API documentation。

因為 Constraints 物件的屬性（表示其邊、大小和位置）都可以單獨設置，並且互相關聯，所以 Constraints 物件可以成為過分約束。例如，如果設置了 WEST、WIDTH 和 EAST 邊，則必須採取措施以確保上述公式中的第一個有效。要做到這一點，Constraints 物件拋出最近設置的 約束以使公式有效。

從以下版本開始：

1.4

建構子摘要

SpringLayout.Constraints()
創建一個空 Constraints 物件。

SpringLayout.Constraints(Component c)
創建元件 c 的合適 x、y、width 和 height spring 的 Constraints 物件。

SpringLayout.Constraints(Spring x, Spring y)
創建一個指定了 x 和 y 屬性值的 Constraints 物件。

SpringLayout.Constraints(Spring x, Spring y, Spring width, Spring height)
創建一個指定了 x、y、width 和 height 屬性值的 Constraints 物件。

方法摘要

Spring	getConstraint(String edgeName) 返回指定邊的值，它可以為一個派生值，甚至可以為 null。
Spring	getHeight() 返回 height 屬性的值。
Spring	getWidth() 返回 width 屬性的值。
Spring	getX() 返回 x 屬性的值。
Spring	getY() 返回 y 屬性的值。
void	setConstraint(String edgeName, Spring s) 設置控制指定邊的 spring。
void	setHeight(Spring height) 設置 height 屬性，該屬性控制元件的高度。
void	setWidth(Spring width) 設置 width 屬性，該屬性控制元件的寬度。
void	setX(Spring x) 設置 x 屬性，該屬性控制元件位置的 x 值。
void	setY(Spring y) 設置 y 屬性，該屬性控制元件位置的 y 值。

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

建構子詳細資訊

SpringLayout.Constraints

public SpringLayout.Constraints()

創建一個空 Constraints 物件。

SpringLayout.Constraints

public SpringLayout.Constraints(Spring x,
                                Spring y)

創建一個指定了 x 和 y 屬性值的 Constraints 物件。height 和 width spring 具有 null 值。

參數：

x - 控制元件的 x 值的 spring

y - 控制元件的 y 值的 spring

SpringLayout.Constraints

public SpringLayout.Constraints(Spring x,
                                Spring y,
                                Spring width,
                                Spring height)

創建一個指定了 x、y、width 和 height 屬性值的 Constraints 物件。註：如果 SpringLayout 類別在給定元件的 Constraints 物件中遇到 null 值，則它將使用合適的預設值取代這些值。

參數：

x - x 屬性的 spring 值

y - y 屬性的 spring 值

width - width 屬性的 spring 值

height - height 屬性的 spring 值

SpringLayout.Constraints

public SpringLayout.Constraints(Component c)

創建元件 c 的合適 x、y、width 和 height spring 的 Constraints 物件。x 和 y spring 是使用調用此方法時該元件的位置初始化的常數 spring。width 和 height spring 是由 Spring.width() 和 Spring.height() 方法創建的特殊 spring，這些方法可在元件的大小特徵發生變化時進行追蹤。

參數：

c - 此約束物件反映其特徵的元件

拋出：

NullPointerException - 如果 c 為 null。

從以下版本開始：

1.5

方法詳細資訊

setX

public void setX(Spring x)

設置 x 屬性，該屬性控制元件位置的 x 值。

參數：

x - 控制元件位置的 x 值的 spring

另請參見：

getX(), SpringLayout.Constraints

getX

public Spring getX()

返回 x 屬性的值。

返回：

控制元件位置的 x 值的 spring

另請參見：

setX(javax.swing.Spring), SpringLayout.Constraints

setY

public void setY(Spring y)

設置 y 屬性，該屬性控制元件位置的 y 值。

參數：

y - 控制元件位置的 y 值的 spring

另請參見：

getY(), SpringLayout.Constraints

getY

public Spring getY()

返回 y 屬性的值。

返回：

控制元件位置的 y 值的 spring

另請參見：

setY(javax.swing.Spring), SpringLayout.Constraints

setWidth

public void setWidth(Spring width)

設置 width 屬性，該屬性控制元件的寬度。

參數：

width - 控制此 Constraints 物件的寬度的 spring

另請參見：

getWidth(), SpringLayout.Constraints

getWidth

public Spring getWidth()

返回 width 屬性的值。

返回：

控制元件寬度的 spring

另請參見：

setWidth(javax.swing.Spring), SpringLayout.Constraints

setHeight

public void setHeight(Spring height)

設置 height 屬性，該屬性控制元件的高度。

參數：

height - 控制此 Constraints 物件高度的 spring

另請參見：

getHeight(), SpringLayout.Constraints

getHeight

public Spring getHeight()

返回 height 屬性的值。

返回：

控制元件高度的 spring

另請參見：

setHeight(javax.swing.Spring), SpringLayout.Constraints

setConstraint

public void setConstraint(String edgeName,
                          Spring s)

設置控制指定邊的 spring。該邊必須是以下某個值：SpringLayout.NORTH、SpringLayout.SOUTH、SpringLayout.EAST、SpringLayout.WEST、SpringLayout.HORIZONTAL_CENTER、SpringLayout.VERTICAL_CENTER、SpringLayout.BASELINE、SpringLayout.WIDTH 或 SpringLayout.HEIGHT。 對於作為邊傳遞的任何其他 String 值，則不執行任何操作。對於 null 邊，則拋出 NullPointerException。

參數：

edgeName - 要設置的邊

s - 控制指定邊的 spring

拋出：

NullPointerException - 如果 edgeName 為 null

另請參見：

getConstraint(java.lang.String), SpringLayout.NORTH, SpringLayout.SOUTH, SpringLayout.EAST, SpringLayout.WEST, SpringLayout.HORIZONTAL_CENTER, SpringLayout.VERTICAL_CENTER, SpringLayout.BASELINE, SpringLayout.WIDTH, SpringLayout.HEIGHT, SpringLayout.Constraints

getConstraint

public Spring getConstraint(String edgeName)

返回指定邊的值，它可以為一個派生值，甚至可以為 null。該邊必須是以下某個值：SpringLayout.NORTH、SpringLayout.SOUTH、SpringLayout.EAST、SpringLayout.WEST、SpringLayout.HORIZONTAL_CENTER、SpringLayout.VERTICAL_CENTER、SpringLayout.BASELINE、SpringLayout.WIDTH 或 SpringLayout.HEIGHT。 對於作為邊傳遞的任何其他 String 值，則會返回 null。對於 null 邊，則拋出 NullPointerException。

參數：

edgeName - 要返回其值的邊

返回：

控制指定邊的 spring，可以為 null

拋出：

NullPointerException - 如果 edgeName 為 null

另請參見：

setConstraint(java.lang.String, javax.swing.Spring), SpringLayout.NORTH, SpringLayout.SOUTH, SpringLayout.EAST, SpringLayout.WEST, SpringLayout.HORIZONTAL_CENTER, SpringLayout.VERTICAL_CENTER, SpringLayout.BASELINE, SpringLayout.WIDTH, SpringLayout.HEIGHT, SpringLayout.Constraints