モジュール java.desktop
パッケージ 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

  • コンストラクタのサマリー

    コンストラクタ 
    コンストラクタ 説明
    Constraints()
    空のConstraintsオブジェクトを作成します。
    Constraints​(Component c)
    コンポーネントcに適したスプリング(x、y、width、およびheight)を使用して、Constraintsオブジェクトを作成します。
    Constraints​(Spring x, Spring y)
    xプロパティとyプロパティの値を指定して、Constraintsオブジェクトを作成します。
    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

  • コンストラクタの詳細

    • Constraints

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

    • Constraints

      public Constraints​(Spring x, Spring y)
      xプロパティとyプロパティの値を指定して、Constraintsオブジェクトを作成します。 heightスプリングとwidthスプリングはnull値です。
      パラメータ:
      x - コンポーネントのx値を制御するスプリング
      y - コンポーネントのy値を制御するスプリング

    • Constraints

      public 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プロパティのスプリング値

    • Constraints

      public Constraints​(Component c)
      コンポーネントcに適したスプリング(x、y、width、およびheight)を使用して、Constraintsオブジェクトを作成します。 xおよびyの各スプリングは、このメソッドが呼び出されたときにコンポーネントの位置で初期化される定数スプリングです。 widthおよびheightの各スプリングは、Spring.width()およびSpring.height()メソッドによって作成される特殊なスプリングで、コンポーネントのサイズ特性をその変更に伴って追跡します。
      パラメータ:
      c - このConstraintsオブジェクトによって特性が反映されるコンポーネント
      例外:
      NullPointerException - cがnullである場合。
      導入されたバージョン:
      1.5

  • メソッドの詳細