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

  • メソッドの詳細

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