モジュール java.desktop
パッケージ 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からの値を示します。 次の例では、範囲の値を指定して、groupmyComponentを追加します。 つまり、最小値は100、推奨値は200、最大値は300と明示的に指定されます。

       group.addComponent(myComponent, 100, 200, 300);
     
    次の例では、形式の組み合わせを使ってgroupmyComponentを追加します。 最小サイズは強制的に推奨サイズと同じになり、推奨サイズは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_SIZEPREFERRED_SIZE
        pref - 推奨サイズ、またはDEFAULT_SIZEPREFERRED_SIZE
        max - 最大サイズ、またはDEFAULT_SIZEPREFERRED_SIZE
        戻り値:
        このGroup
      • addGap

        public GroupLayout.Group addGap​(int size)
        このGroupに固定のギャップを追加します。
        パラメータ:
        size - ギャップのサイズ
        戻り値:
        このGroup
        例外:
        IllegalArgumentException - size0より前の場合
      • addGap

        public GroupLayout.Group addGap​(int min,
                                        int pref,
                                        int max)
        指定のサイズで、このGroupにギャップを追加します。
        パラメータ:
        min - ギャップの最小サイズ
        pref - ギャップの推奨サイズ
        max - ギャップの最大サイズ
        戻り値:
        このGroup
        例外:
        IllegalArgumentException - 0より小さい値が1つでもある場合