SpringLayout (Java Platform SE 8)

java.lang.Object
- javax.swing.SpringLayout

すべての実装されたインタフェース:

LayoutManager, LayoutManager2
```
public class SpringLayout
extends Object
implements LayoutManager2
```
SpringLayoutは、関連付けられているコンテナの子を一連の制約に従ってレイアウトします。SpringLayoutの使用例については、「The Java Tutorial」の「How to Use SpringLayout」を参照してください。
Springオブジェクトで表される各制約は、2つのコンポーネント・エッジ間の垂直方向または水平方向の距離を制御します。エッジは、コンテナの子またはコンテナ自身に属すことができます。たとえば、許容されるコンポーネントの幅は、コンポーネントの西(左)のエッジと東(右)のエッジ間の距離を制御する制約を使用して表現できます。許容されるコンポーネントのy座標は、コンポーネントの北(上端)のエッジとそのコンテナの北のエッジ間の距離の制約によって表現できます。
SpringLayoutによって制御されるコンテナのすべての子は、コンテナ自身と同様に、関連する制約を1セットのみ持ちます。制約は、SpringLayout.Constraintsオブジェクトによって表現されます。SpringLayoutがデフォルトで作成する制約では、関連するコンポーネントに、コンポーネントのComponent.getMinimumSize()メソッド、Component.getPreferredSize()メソッドおよびComponent.getMaximumSize()メソッドが返す最小サイズ、推奨サイズおよび最大サイズが設定されます。xとyの位置は初期状態では制約が設定されていないため、Componentの位置は、制約を設定するまで親ContainerのInsetsに対して0,0となります。
コンポーネントの制約を変更するには複数の方法があります。putConstraintメソッドのいずれかを使用すると、同一コンテナ内の2つのコンポーネントのエッジに接続するスプリングを確立できます。また、getConstraintsメソッドを使用すると、適切なSpringLayout.Constraintsオブジェクトを取得でき、その後1つ以上のスプリングを変更できます。getConstraintメソッドを使用すると、コンポーネントの特定のエッジに対するスプリングを取得でき、その後スプリングを変更できます。Container.add(Component, Object)を使用すると、コンポーネントをコンテナに追加するときに制約オブジェクトを指定することにより、独自のSpringLayout.Constraintsオブジェクトをコンポーネントに関連付けることができます。
各制約を表すSpringオブジェクトには、最小値(minimum値)、推奨値(preferred値)、最大値(maximum値)および現在の値が設定されます。スプリングの現在の値は、最小値と最大値の間にある値で、Spring.sum(javax.swing.Spring, javax.swing.Spring)メソッドの説明で示される式に従います。最小値、推奨値および最大値が等しい場合、現在の値も常にこれらと等しくなります。このような柔軟性のないスプリングは、柱(strut)と呼ばれます。ファクトリ・メソッドのSpring.constant(int)を使用すると、柱を生成できます。Springクラスには、別のスプリングに依存するスプリングなど、その他の種類のスプリングを作成するファクトリ・メソッドも用意されています。
SpringLayoutでは、各エッジの位置は別の1つのエッジのみの位置に依存します。制約を後で追加してエッジに新しいバインディングを作成すると、以前のバインディングは破棄され、エッジは1つのエッジのみに依存する状態のまま維持されます。スプリングは、コンテナとその直接の子のエッジ間にのみ接続される必要があります。SpringLayoutの動作は、別のコンテナの内部または外部からコンポーネントのエッジに接続する制約によって表現される場合、定義されません。
SpringLayoutとその他のレイアウト・マネージャ

注: 多くのレイアウト・マネージャとは異なり、SpringLayoutは、管理するコンポーネントの位置を自動的に設定しません。SpringLayoutを使用するGUIをハンドコーディングする場合は、西/東および北/南の位置に制約を設定することによって、コンポーネントの位置を初期化してください。
使用する制約によっては、コンテナのサイズを明示的に設定することが必要な場合もあります。

SpringLayoutは単純ですが、ほとんどのレイアウト・マネージャの動作をエミュレートできます。FlowLayoutの行ブレークのような機能については、Springクラスに専用のサブクラスを作成する必要があります。
SpringLayoutを使用すると、Boxを入れ子にした組合わせでは解決できないような、レイアウトに関する難しい問題も多く解決できます。SpringLayoutはLayoutManager2規約を正確に遵守しているため、他のレイアウト・マネージャを入れ子にできます。これは、他のレイアウト・マネージャに含まれる制約を作成する方法よりも望ましい方法です。
SpringLayoutによるレイアウト・オペレーションの漸近的複雑性は、制約またはコンポーネント、あるいはその両方の数に比例します。
警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。1.4以降、すべてのJavaBeans(tm)用の長期間の格納サポートがjava.beansパッケージに追加されています。XMLEncoderを参照してください。

導入されたバージョン:

1.4

関連項目:

Spring, SpringLayout.Constraints

ネストされたクラスのサマリー

ネストされたクラス
修飾子と型	クラスと説明
`static class`	`SpringLayout.Constraints` `Constraints`オブジェクトは、`SpringLayout`が制御するコンテナ内のコンポーネントのサイズ変更方法および位置変更方法を決定する制約を保持します。

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static String`	`BASELINE` コンポーネントのベースラインを指定します。
`static String`	`EAST` コンポーネントの境界の矩形の右端を指定します。
`static String`	`HEIGHT` コンポーネントの境界の矩形の高さを指定します。
`static String`	`HORIZONTAL_CENTER` コンポーネントの境界の矩形の水平方向の中心を指定します。
`static String`	`NORTH` コンポーネントの境界の矩形の上端を指定します。
`static String`	`SOUTH` コンポーネントの境界の矩形の下端を指定します。
`static String`	`VERTICAL_CENTER` コンポーネントの境界の矩形の垂直方向の中心を指定します。
`static String`	`WEST` コンポーネントの境界の矩形の左端を指定します。
`static String`	`WIDTH` コンポーネントの境界の矩形の幅を指定します。

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

コンストラクタ
コンストラクタと説明

SpringLayout()
新しいSpringLayoutを構築します。

コンストラクタ
コンストラクタと説明
`SpringLayout()` 新しい`SpringLayout`を構築します。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`addLayoutComponent(Component component, Object constraints)` `constraints`が`SpringLayout.Constraints`のインスタンスである場合は、指定されたコンポーネントに制約を関連付けます。
`void`	`addLayoutComponent(String name, Component c)` このレイアウト・マネージャはコンポーネントごとの文字列を使用しないため、何もしません。
`Spring`	`getConstraint(String edgeName, Component c)` コンポーネントの指定されたエッジと親の上端または左端との間の距離を制御するスプリングを返します。
`SpringLayout.Constraints`	`getConstraints(Component c)` 指定されたコンポーネントの制約を返します。
`float`	`getLayoutAlignmentX(Container p)` 0.5f (中央揃え)を返します。
`float`	`getLayoutAlignmentY(Container p)` 0.5f (中央揃え)を返します。
`void`	`invalidateLayout(Container p)` レイアウトを無効にします。このとき、レイアウト・マネージャが情報をキャッシュしていればそれを破棄します。
`void`	`layoutContainer(Container parent)` 指定されたコンテナを配置します。
`Dimension`	`maximumLayoutSize(Container parent)` 指定されたコンテナにコンポーネントが含まれている場合の、最大サイズを計算します。
`Dimension`	`minimumLayoutSize(Container parent)` 指定されたコンテナに含まれているコンポーネントを基に、コンテナの最小サイズを計算します。
`Dimension`	`preferredLayoutSize(Container parent)` 指定されたコンテナに含まれているコンポーネントを基に、コンテナの推奨サイズを計算します。
`void`	`putConstraint(String e1, Component c1, int pad, String e2, Component c2)` コンポーネント`c1`のエッジ`e1`をコンポーネント`c2`のエッジ`e2`にリンクします。エッジ間の距離は固定です。
`void`	`putConstraint(String e1, Component c1, Spring s, String e2, Component c2)` コンポーネント`c1`のエッジ`e1`をコンポーネント`c2`のエッジ`e2`にリンクします。
`void`	`removeLayoutComponent(Component c)` 指定されたコンポーネントに関連付けれられた制約を削除します。

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- フィールドの詳細
  - NORTH
```
public static final String NORTH
```
    コンポーネントの境界の矩形の上端を指定します。
    
    関連項目:
    
    定数フィールド値
  - SOUTH
```
public static final String SOUTH
```
    コンポーネントの境界の矩形の下端を指定します。
    
    関連項目:
    
    定数フィールド値
  - EAST
```
public static final String EAST
```
    コンポーネントの境界の矩形の右端を指定します。
    
    関連項目:
    
    定数フィールド値
  - WEST
```
public static final String WEST
```
    コンポーネントの境界の矩形の左端を指定します。
    
    関連項目:
    
    定数フィールド値
  - HORIZONTAL_CENTER
```
public static final String HORIZONTAL_CENTER
```
    コンポーネントの境界の矩形の水平方向の中心を指定します。
    
    導入されたバージョン:
    
    1.6
    
    関連項目:
    
    定数フィールド値
  - VERTICAL_CENTER
```
public static final String VERTICAL_CENTER
```
    コンポーネントの境界の矩形の垂直方向の中心を指定します。
    
    導入されたバージョン:
    
    1.6
    
    関連項目:
    
    定数フィールド値
  - BASELINE
```
public static final String BASELINE
```
    コンポーネントのベースラインを指定します。
    
    導入されたバージョン:
    
    1.6
    
    関連項目:
    
    定数フィールド値
  - WIDTH
```
public static final String WIDTH
```
    コンポーネントの境界の矩形の幅を指定します。
    
    導入されたバージョン:
    
    1.6
    
    関連項目:
    
    定数フィールド値
  - HEIGHT
```
public static final String HEIGHT
```
    コンポーネントの境界の矩形の高さを指定します。
    
    導入されたバージョン:
    
    1.6
    
    関連項目:
    
    定数フィールド値
- コンストラクタの詳細
  - SpringLayout
```
public SpringLayout()
```
    新しいSpringLayoutを構築します。
- メソッドの詳細
  - addLayoutComponent
```
public void addLayoutComponent(String name,
                               Component c)
```
    このレイアウト・マネージャはコンポーネントごとの文字列を使用しないため、何もしません。
    
    定義:
    
    addLayoutComponent、インタフェース: LayoutManager
    
    パラメータ:
    
    name - コンポーネントに関連付けられる文字列
    
    c - 追加されるコンポーネント
  - removeLayoutComponent
```
public void removeLayoutComponent(Component c)
```
    指定されたコンポーネントに関連付けれられた制約を削除します。
    
    定義:
    
    removeLayoutComponent、インタフェース: LayoutManager
    
    パラメータ:
    
    c - コンテナから削除されるコンポーネント
  - minimumLayoutSize
```
public Dimension minimumLayoutSize(Container parent)
```
    インタフェースからコピーされた説明: LayoutManager
    
    指定されたコンテナに含まれているコンポーネントを基に、コンテナの最小サイズを計算します。
    
    定義:
    
    minimumLayoutSize、インタフェース: LayoutManager
    
    パラメータ:
    
    parent - 配置されるコンポーネント
    
    関連項目:
    
    LayoutManager.preferredLayoutSize(java.awt.Container)
  - preferredLayoutSize
```
public Dimension preferredLayoutSize(Container parent)
```
    インタフェースからコピーされた説明: LayoutManager
    
    指定されたコンテナに含まれているコンポーネントを基に、コンテナの推奨サイズを計算します。
    
    定義:
    
    preferredLayoutSize、インタフェース: LayoutManager
    
    パラメータ:
    
    parent - 配置されるコンテナ
    
    関連項目:
    
    LayoutManager.minimumLayoutSize(java.awt.Container)
  - maximumLayoutSize
```
public Dimension maximumLayoutSize(Container parent)
```
    次のインタフェースからコピーされた説明: LayoutManager2
    
    指定されたコンテナにコンポーネントが含まれている場合の、最大サイズを計算します。
    
    定義:
    
    maximumLayoutSize、インタフェース: LayoutManager2
    
    関連項目:
    
    Component.getMaximumSize(), LayoutManager
  - addLayoutComponent
```
public void addLayoutComponent(Component component,
                               Object constraints)
```
    constraintsがSpringLayout.Constraintsのインスタンスである場合は、指定されたコンポーネントに制約を関連付けます。
    
    定義:
    
    addLayoutComponent、インタフェース: LayoutManager2
    
    パラメータ:
    
    component - 追加するコンポーネント
    
    constraints - コンポーネントの制約
    
    関連項目:
    
    SpringLayout.Constraints
  - getLayoutAlignmentX
```
public float getLayoutAlignmentX(Container p)
```
    0.5f (中央揃え)を返します。
    
    定義:
    
    getLayoutAlignmentX、インタフェース: LayoutManager2
  - getLayoutAlignmentY
```
public float getLayoutAlignmentY(Container p)
```
    0.5f (中央揃え)を返します。
    
    定義:
    
    getLayoutAlignmentY、インタフェース: LayoutManager2
  - invalidateLayout
```
public void invalidateLayout(Container p)
```
    次のインタフェースからコピーされた説明: LayoutManager2
    
    レイアウトを無効にします。このとき、レイアウト・マネージャが情報をキャッシュしていればそれを破棄します。
    
    定義:
    
    invalidateLayout、インタフェース: LayoutManager2
  - putConstraint
```
public void putConstraint(String e1,
                          Component c1,
                          int pad,
                          String e2,
                          Component c2)
```
    コンポーネントc1のエッジe1をコンポーネントc2のエッジe2にリンクします。エッジ間の距離は固定です。この制約により、代入
```
     value(e1, c1) = value(e2, c2) + pad
```
    が後続のすべてのレイアウト・オペレーションで発生します。
    パラメータ:
    
    e1 - 依存するエッジ
    
    c1 - 依存するコンポーネント
    
    pad - 依存する側とされる側の間の固定距離
    
    e2 - 依存されるエッジ
    
    c2 - 依存されるコンポーネント
    
    関連項目:
    
    putConstraint(String, Component, Spring, String, Component)
  - putConstraint
```
public void putConstraint(String e1,
                          Component c1,
                          Spring s,
                          String e2,
                          Component c2)
```
    コンポーネントc1のエッジe1をコンポーネントc2のエッジe2にリンクします。エッジ(e2, c2)の値が変更されると、(e2, c2)とsの(スプリング)和をとることによってエッジ(e1, c1)が計算されます。各エッジに、SpringLayout.NORTH、SpringLayout.SOUTH、SpringLayout.EAST、SpringLayout.WEST、SpringLayout.VERTICAL_CENTER、SpringLayout.HORIZONTAL_CENTERまたはSpringLayout.BASELINEのいずれかの値が設定されている必要があります。
    
    パラメータ:
    
    e1 - 依存するエッジ
    
    c1 - 依存するコンポーネント
    
    s - 依存する側と依存される側を接続するスプリング
    
    e2 - 依存されるエッジ
    
    c2 - 依存されるコンポーネント
    
    関連項目:
    
    putConstraint(String, Component, int, String, Component), NORTH, SOUTH, EAST, WEST, VERTICAL_CENTER, HORIZONTAL_CENTER, BASELINE
  - getConstraints
```
public SpringLayout.Constraints getConstraints(Component c)
```
    指定されたコンポーネントの制約を返します。GridBagLayout getConstraintsメソッドとは異なり、このメソッドは制約を複製しません。コンポーネントに関連付けられた制約がない場合は、親のインセットに対して0,0の位置にあるデフォルトの制約オブジェクトを返します。幅と高さはコンポーネントの最小サイズ、最大サイズおよび推奨サイズに制約されます。メソッドが呼び出された時点でサイズの特性は凍結されませんが、コンポーネントの特性が変更されるとそれを追跡する特性を持つ制約オブジェクトを返します。
    
    パラメータ:
    
    c - 返される制約を持つコンポーネント
    
    戻り値:
    
    指定されたコンポーネントの制約
  - getConstraint
```
public Spring getConstraint(String edgeName,
                            Component c)
```
    コンポーネントの指定されたエッジと親の上端または左端との間の距離を制御するスプリングを返します。このメソッドは、エッジに対する現在のバインディングを返すのではなく、エッジを後で再度バインドする場合にもエッジの特性を追跡するプロキシを返します。プロキシは、構築環境での使用を目的としています。構築環境では、ユーザーが任意の順序でレイアウトの制約を定義できるようにすることが便利です。ただし、プロキシは、レイアウトの制約間の循環的な依存関係を作成する手段を提供します。そのようなサイクルは、レイアウト・オペレーションがいつでも終了できるように、SpringLayoutによって内部的に検出されます。
    
    パラメータ:
    
    edgeName - SpringLayout.NORTH、SpringLayout.SOUTH、SpringLayout.EAST、SpringLayout.WEST、SpringLayout.VERTICAL_CENTER、SpringLayout.HORIZONTAL_CENTERまたはSpringLayout.BASELINEのいずれか
    
    c - エッジ・スプリングを要求されるコンポーネント
    
    戻り値:
    
    指定されたエッジからその親の上端または左端までの距離を制御するスプリングのプロキシ
    
    関連項目:
    
    NORTH, SOUTH, EAST, WEST, VERTICAL_CENTER, HORIZONTAL_CENTER, BASELINE
  - layoutContainer
```
public void layoutContainer(Container parent)
```
    インタフェースからコピーされた説明: LayoutManager
    
    指定されたコンテナを配置します。
    
    定義:
    
    layoutContainer、インタフェース: LayoutManager
    
    パラメータ:
    
    parent - 配置されるコンテナ

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスSpringLayout

SpringLayoutとその他のレイアウト・マネージャ

ネストされたクラスのサマリー

フィールドのサマリー

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

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

フィールドの詳細

NORTH

SOUTH

EAST

WEST

HORIZONTAL_CENTER

VERTICAL_CENTER

BASELINE

WIDTH

HEIGHT

コンストラクタの詳細

SpringLayout

メソッドの詳細

addLayoutComponent

removeLayoutComponent

minimumLayoutSize

preferredLayoutSize

maximumLayoutSize

addLayoutComponent

getLayoutAlignmentX

getLayoutAlignmentY

invalidateLayout

putConstraint

putConstraint

getConstraints

getConstraint

layoutContainer