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