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 を取得し、それを別の GroupLayout で使用する場合、結果は保証されません。

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 を渡されると IllegalArgumentException をスローします。また、Group を取るすべてのメソッドは、null を渡されると NullPointerException をスローします。

導入されたバージョン:

1.6

関連項目:

GroupLayout.createSequentialGroup(), GroupLayout.createParallelGroup()

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
GroupLayout.Group	addComponent(Component component) Component をこの Group に追加します。
GroupLayout.Group	addComponent(Component component, int min, int pref, int max) Component をこの Group に指定されたサイズで追加します。
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)

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

パラメータ:

component - 追加する Component

戻り値:

この Group

addComponent

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

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

パラメータ:

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 つでもある場合