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