javax.swing
Class Spring

java.lang.Object
  |
  +--javax.swing.Spring

Direct Known Subclasses:

javax.swing.Spring.AbstractSpring, javax.swing.Spring.NegativeSpring, javax.swing.SpringLayout.SpringProxy

public abstract class Spring

extends Object

Safe:

Field Summary

static int

UNSET Enabled: An integer value signifying that a property value has not yet been calculated.

Constructor Summary

protected

Spring() Used by factory methods to create a Spring.

Method Summary

static Spring	constant(int pref) Enabled: Returns a strut -- a spring whose minimum, preferred, and maximum values each have the value pref.
static Spring	constant(int min, int pref, int max) Enabled: Returns a spring whose minimum, preferred, and maximum values have the values: min, pref, and max respectively.
(package private) static Spring	difference(Spring s1, Spring s2)
abstract int	getMaximumValue() Enabled: Returns the maximum value of this Spring.
abstract int	getMinimumValue() Enabled: Returns the minimum value of this Spring.
abstract int	getPreferredValue() Enabled: Returns the preferred value of this Spring.
(package private) double	getStrain()
abstract int	getValue() Enabled: Returns the current value of this Spring.
(package private) boolean	isCyclic(SpringLayout l)
static Spring	max(Spring s1, Spring s2) Enabled: Returns max(s1, s2): a spring whose value is always greater than (or equal to) the values of both s1 and s2.
static Spring	minus(Spring s) Enabled: Returns -s: a spring running in the opposite direction to s.
private double	range(boolean contract)
(package private) void	setStrain(double strain)
abstract void	setValue(int value) Enabled: Sets the current value of this Spring to value.
static Spring	sum(Spring s1, Spring s2) Enabled: Returns s1+s2: a spring representing s1 and s2 in series.

Methods inherited from class java.lang.Object

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

Field Detail

UNSET

public static final int UNSET

Enabled: An integer value signifying that a property value has not yet been calculated.

Constructor Detail

Spring

protected Spring()

Used by factory methods to create a Spring.

See Also:

constant(int), constant(int, int, int), max(javax.swing.Spring, javax.swing.Spring), minus(javax.swing.Spring), sum(javax.swing.Spring, javax.swing.Spring), SpringLayout.Constraints

Method Detail

getMinimumValue

public abstract int getMinimumValue()

Enabled: Returns the minimum value of this Spring.

Returns:

the minimumValue property of this Spring

getPreferredValue

public abstract int getPreferredValue()

Enabled: Returns the preferred value of this Spring.

Returns:

the preferredValue of this Spring

getMaximumValue

public abstract int getMaximumValue()

Enabled: Returns the maximum value of this Spring.

Returns:

the maximumValue property of this Spring

getValue

public abstract int getValue()

Enabled: Returns the current value of this Spring.

Returns:

the value property of this Spring

See Also:

setValue(int)

setValue

public abstract void setValue(int value)

Enabled: Sets the current value of this Spring to value.

Parameters:

value - the new setting of the value property

See Also:

getValue()

range

private double range(boolean contract)

getStrain

double getStrain()

setStrain

void setStrain(double strain)

isCyclic

boolean isCyclic(SpringLayout l)

constant

public static Spring constant(int pref)

Enabled: Returns a strut -- a spring whose minimum, preferred, and maximum values each have the value pref.

Parameters:

pref - the minimum, preferred, and maximum values of the new spring

Returns:

a spring whose minimum, preferred, and maximum values each have the value pref

See Also:

AbstractSpring

constant

public static Spring constant(int min,
                              int pref,
                              int max)

Enabled: Returns a spring whose minimum, preferred, and maximum values have the values: min, pref, and max respectively.

Parameters:

min - the minimum value of the new spring

pref - the preferred value of the new spring

max - the maximum value of the new spring

Returns:

a spring whose minimum, preferred, and maximum values have the values: min, pref, and max respectively

See Also:

AbstractSpring

minus

public static Spring minus(Spring s)

Enabled: Returns -s: a spring running in the opposite direction to s.

Returns:

-s: a spring running in the opposite direction to s

See Also:

AbstractSpring

sum

public static Spring sum(Spring s1,
                         Spring s2)

Enabled: Returns s1+s2: a spring representing s1 and s2 in series. In a sum, s3, of two springs, s1 and s2, the strains of s1, s2, and s3 are maintained at the same level (to within the precision implied by their integer values). The strain of a spring in compression is:

         value - pref
         ------------
          pref - min
 

and the strain of a spring in tension is:

         value - pref
         ------------
          max - pref
 

When setValue is called on the sum spring, s3, the strain in s3 is calculated using one of the formulas above. Once the strain of the sum is known, the values of s1 and s2 are then set so that they are have a strain equal to that of the sum. The formulas are evaluated so as to take rounding errors into account and ensure that the sum of the values of s1 and s2 is exactly equal to the value of s3.

Returns:

s1+s2: a spring representing s1 and s2 in series

See Also:

AbstractSpring

max

public static Spring max(Spring s1,
                         Spring s2)

Enabled: Returns max(s1, s2): a spring whose value is always greater than (or equal to) the values of both s1 and s2.

Returns:

max(s1, s2): a spring whose value is always greater than (or equal to) the values of both s1 and s2

See Also:

AbstractSpring

difference

static Spring difference(Spring s1,
                         Spring s2)