javax.swing
クラス GroupLayout.Group

java.lang.Object
  javax.swing.GroupLayout.Group

直系の既知のサブクラス:

GroupLayout.ParallelGroup, GroupLayout.SequentialGroup

含まれているクラス:

GroupLayout

public abstract class GroupLayout.Group
extends Object

Group は、GroupLayout でサポートされる 2 種類のオペレーションの基盤になります。2 種類のオペレーションには、コンポーネントを 1 つずつレイアウトする処理 (SequentialGroup) と、配置処理 (ParallelGroup) があります。Group とそのサブクラスには、public コンストラクタがありません。作成するには、createSequentialGroup または createParallelGroup を使用します。また、GroupLayout から作成済みの Group を取り出し、別の場所で使用すると、結果は保証されません。

Group およびそのサブクラス内のさまざまなメソッドを使って、範囲を明示的に指定できます。これらのメソッドの引数は 2 とおりの形式をとります。1 つは 0 以上の値、もう 1 つは DEFAULT_SIZE または PREFERRED_SIZE です。0 以上の値は、特定のサイズを示します。DEFAULT_SIZE は、使用すべきコンポーネントの対応するサイズを示します。たとえば、DEFAULT_SIZE が最小サイズの引数として渡される場合、最小サイズはコンポーネント上で getMinimumSize を呼び出すことで取得されます。同様に、PREFERRED_SIZE は使用すべき getPreferredSize からの値を示します。次の例では、範囲の値を指定して、group に myComponent を追加します。最小値は 100、推奨値は 200、最大値は 300 と明示的に指定されます。

   group.addComponent(myComponent, 100, 200, 300);
 

次の例では、形式の組み合わせを使って group に myComponent を追加します。最小サイズは強制的に推奨サイズと同じになり、推奨サイズは myComponent.getPreferredSize によって決定され、最大サイズはコンポーネント上で getMaximumSize を呼び出すことによって決定されます。

   group.addComponent(myComponent, GroupLayout.PREFERRED_SIZE,
             GroupLayout.PREFERRED_SIZE, GroupLayout.DEFAULT_SIZE);
 

特に指定がないかぎり、範囲指定を可能にする Group とそのサブクラスのすべてのメソッドは、有効な範囲が渡されると IllegalArgumentException をスローします。0 より小さい値が 1 つでもあるか、PREFERRED_SIZE または DEFAULT_SIZE, ではないか、特定の値に対して次の条件が満たされていない場合、その範囲は無効です。min <= pref <= max.

同様に、Component を取るすべてのメソッドは、null を渡されると NullPointerException をスローします。また、Group を取るすべてのメソッドは、null を渡されると IllegalArgumentException をスローします。

導入されたバージョン:

1.6

関連項目:

GroupLayout.createSequentialGroup(), GroupLayout.createParallelGroup()

メソッドの概要

GroupLayout.Group	addComponent(Component component) この Group に Component を追加します。
GroupLayout.Group	addComponent(Component component, int min, int pref, int max) 指定のサイズで、この Group に Component を追加します。
GroupLayout.Group	addGap(int size) この Group に固定のギャップを追加します。
GroupLayout.Group	addGap(int min, int pref, int max) 指定のサイズで、この Group にギャップを追加します。
GroupLayout.Group	addGroup(GroupLayout.Group group) この Group に Group を追加します。

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

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

メソッドの詳細

addGroup

public GroupLayout.Group addGroup(GroupLayout.Group group)

この Group に Group を追加します。

パラメータ:

group - 追加する Group

戻り値:

この Group

addComponent

public GroupLayout.Group addComponent(Component component)

この Group に Component を追加します。

パラメータ:

component - 追加する Component

戻り値:

この Group

addComponent

public GroupLayout.Group addComponent(Component component,
                                      int min,
                                      int pref,
                                      int max)

指定のサイズで、この Group に Component を追加します。

パラメータ:

component - 追加する Component

min - 最小サイズ、または DEFAULT_SIZE か PREFERRED_SIZE

pref - 推奨サイズ、または DEFAULT_SIZE か PREFERRED_SIZE

max - 最大サイズ、または DEFAULT_SIZE か PREFERRED_SIZE

戻り値:

この Group

addGap

public GroupLayout.Group addGap(int size)

この Group に固定のギャップを追加します。

パラメータ:

size - ギャップのサイズ

戻り値:

この Group

例外:

IllegalArgumentException - size が 0 未満の場合

addGap

public GroupLayout.Group addGap(int min,
                                int pref,
                                int max)

指定のサイズで、この Group にギャップを追加します。

パラメータ:

min - ギャップの最小サイズ

pref - ギャップの推奨サイズ

max - ギャップの最大サイズ

戻り値:

この Group

例外:

IllegalArgumentException - 0 より小さい値が 1 つでもある場合