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

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

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。