javax.swing
クラス SpringLayout.Constraints

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

含まれているクラス:

SpringLayout

public static class SpringLayout.Constraints
extends Object

Constraints オブジェクトは、SpringLayout が制御するコンテナ内のコンポーネントのサイズ変更方法および位置変更方法を決定する制約を保持します。Constraints オブジェクトには Rectangle と同様に x、y、width、および height の各プロパティーがあります。ただし、Constraints オブジェクトの各プロパティーは、整数ではなく Spring 値です。また、Constraints オブジェクトは、constraint プロパティーを使用して、north、south、east、および west の 4 個のエッジとして操作できます。

次の式は、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 オブジェクトに登録されたときに自動的に設定される private の制約です。]

注 -本書では、演算子は Spring クラスのメソッドを表します。たとえば、「a + b」は Spring.sum(a, b) を示し、「a - b」は Spring.sum(a, Spring.minus(b)) を示します。スプリング演算の詳細については、Spring の API ドキュメントを参照してください。

エッジ、サイズ、および位置を表す Constraints オブジェクトのプロパティーはすべて独立して設定できますが、相互に関係しているため、Constraints オブジェクトが「過剰な制約」を受けることがあります。たとえば、WEST、WIDTH、および EAST のエッジがすべて設定された場合は、前述の 1 つめの式を保持する必要があります。このために、Constraints オブジェクトは「もっとも前に設定された」制約を廃棄して、その式を保持します。

導入されたバージョン:

1.4

コンストラクタの概要

SpringLayout.Constraints()
空の Constraints オブジェクトを作成します。

SpringLayout.Constraints(Component c)
コンポーネント c に適切なスプリング (x、y、width、および height) を指定して、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) 指定されたエッジを制御するスプリングを設定します。
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 スプリングは null 値です。

パラメータ:

x - コンポーネントの x 値を制御するスプリング

y - コンポーネントの y 値を制御するスプリング

SpringLayout.Constraints

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

x、y、width、height の各プロパティーの値を指定して、Constraints オブジェクトを作成します。注:指定されたコンポーネントの Constraints オブジェクトで、SpringLayout クラスに null 値が設定された場合、null 値は適切なデフォルト値に置換されます。

パラメータ:

x - x プロパティーのスプリング値

y - y プロパティーのスプリング値

width - width プロパティーのスプリング値

height - height プロパティーのスプリング値

SpringLayout.Constraints

public SpringLayout.Constraints(Component c)

コンポーネント c に適切なスプリング (x、y、width、および height) を指定して、Constraints オブジェクトを作成します。x および y の各スプリングは、このメソッドが呼び出されたときにコンポーネントの位置で初期化される定数スプリングです。width および height の各スプリングは、Spring.width() および Spring.height() メソッドによって作成される特殊なスプリングで、コンポーネントのサイズ特性をその変更に伴って追跡します。

パラメータ:

c - この Constraints オブジェクトによって特性が反映されるコンポーネント

例外:

NullPointerException - c が null の場合

導入されたバージョン:

1.5

メソッドの詳細

setX

public void setX(Spring x)

コンポーネントの位置の x 値を制御する x プロパティーを設定します。

パラメータ:

x - コンポーネントの位置の x の値を制御する スプリング

関連項目:

getX(), SpringLayout.Constraints

getX

public Spring getX()

x プロパティーの値を返します。

戻り値:

コンポーネントの位置の x の値を制御する スプリング

関連項目:

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

setY

public void setY(Spring y)

コンポーネントの位置の y 値を制御する y プロパティーを設定します。

パラメータ:

y - コンポーネントの位置の y の値を制御する スプリング

関連項目:

getY(), SpringLayout.Constraints

getY

public Spring getY()

y プロパティーの値を返します。

戻り値:

コンポーネントの位置の y の値を制御する スプリング

関連項目:

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

setWidth

public void setWidth(Spring width)

コンポーネントの幅を制御する width プロパティーを設定します。

パラメータ:

width - この Constraints オブジェクトの幅を制御するスプリング

関連項目:

getWidth(), SpringLayout.Constraints

getWidth

public Spring getWidth()

width プロパティーの値を返します。

戻り値:

コンポーネントの幅を制御するスプリング

関連項目:

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

setHeight

public void setHeight(Spring height)

コンポーネントの高さを制御する height プロパティーを設定します。

パラメータ:

height - この Constraints オブジェクトの高さを制御するスプリング

関連項目:

getHeight(), SpringLayout.Constraints

getHeight

public Spring getHeight()

height プロパティーの値を返します。

戻り値:

コンポーネントの高さを制御するスプリング

関連項目:

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

setConstraint

public void setConstraint(String edgeName,
                          Spring s)

指定されたエッジを制御するスプリングを設定します。エッジには、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 - 指定されたエッジを制御するスプリング

例外:

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 - 値が返される エッジ

戻り値:

指定されたエッジを制御するスプリング。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