クラスGroupLayout.Group

java.lang.Object
javax.swing.GroupLayout.Group
直系の既知のサブクラス:
GroupLayout.ParallelGroup, GroupLayout.SequentialGroup
含まれているクラス:
GroupLayout
public abstract sealed class GroupLayout.Group extends Object permits GroupLayout.ParallelGroup, GroupLayout.SequentialGroup
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.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に追加します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • メソッドの詳細

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