モジュール java.desktop
パッケージ javax.swing

クラスGroupLayout.ParallelGroup

  • 含まれているクラス:
    GroupLayout
    public class GroupLayout.ParallelGroup
extends GroupLayout.Group
    子の配置とサイズ設定を行うGroupです。 ParallelGroupは、ベースラインに揃える、中央に配置する、リーディング・エッジに固定する、トレーリング・エッジに固定する、の4とおりの方法で子を配置します。

    Baseline

    ベースラインに揃えて子を配置するParallelGroupは、まずベースラインをどこに固定するかを決定する必要があります。 ベースラインは、グループの上部または下部に固定できます。 つまり、ベースラインとグループの先頭の距離、またはグループの末尾とベースラインの距離を一定にできます。 選択肢は、BaselineResizeBehavior定数CONSTANT_ASCENTとCONSTANT_DESCENTに対応しています。

    ベースラインのアンカー位置は、createBaselineGroupメソッドにより明示的に指定できます。または、要素に基づいて決定できます。 明示的に指定しないと、ベースラインを持っていてベースラインに揃えてあるすべての要素で、ベースラインのサイズ変更動作がCONSTANT_DESCENTである場合は、ベースラインは下部に固定されます。そうでない場合は、ベースラインはグループの上部に固定されます。

    CONSTANT_ASCENTまたはCONSTANT_DESCENTというベースラインのサイズ変更動作を持つ場合、ベースラインに整列した要素はサイズ変更可能です。 ベースラインのサイズ変更動作がOTHERまたはCENTER_OFFSETである要素のサイズ変更はできません。

    ベースラインは、ベースラインを持つ各要素の適切な高さに基づいて計算されます。 ベースラインは、アルゴリズムmax(maxNonBaselineHeight, maxAscent + maxDescent)を使用して計算されます。maxNonBaselineHeightはベースラインを持たない(ベースラインに揃えて配置されない)すべての要素の高さの最大値です。maxAscentは、ベースラインを持ち、ベースラインに揃えて配置されるすべての要素の最大アセント(ベースライン)です。maxDescentは、ベースラインを持ち、ベースラインに揃えて配置されるすべての要素の最大ディセント(適切な高さ - ベースライン)です。

    ベースラインに揃えて要素を配置するParallelGroupは、垂直軸方向でのみ使用できます。 ベースライン・グループを作成し、水平軸方向で使用した場合、ユーザーがGroupLayoutの最小サイズ、適切なサイズ、または最大サイズを取得しようとしたり、コンポーネントをレイアウトしようとすると、IllegalStateExceptionがスローされます。

    ベースラインに揃えて配置されていない要素と、ParallelGroupよりサイズの小さい要素は、中央に配置する、リーディング・エッジに固定する、トレーリング・エッジに固定する、の3とおりの方法のいずれかで配置されます。

    ベースラインなしのParallelGroup

    BASELINE以外の配置方法を使って作成されたParallelGroupは、グループのサイズより小さい要素を、中央に配置する、リーディング・エッジに固定する、トレーリング・エッジに固定する、の3とおりの方法のいずれかで配置します。

    リーディング・エッジは、軸と ComponentOrientationを基準にして決まります。 垂直軸の場合、上端が常にリーディング・エッジ、下端が常にトレーリング・エッジになります。 ComponentOrientationが LEFT_TO_RIGHTの場合、リーディング・エッジは左端、トレーリング・エッジは右端になります。 ComponentOrientationをRIGHT_TO_LEFTにすると、左端と右端が入れ替わります。 子要素は、その要素の追加に使用された指定の配置方法で配置されます。 配置方法を指定しない場合、ParallelGroupに指定された配置方法が使用されます。

    ベースラインに揃えて要素を配置するには、createBaselineGroupを実行するか、BASELINEの配置方法を使用してcreateParallelGroupを実行します。 ベースラインの配置方法を使用してグループを作成しなかった場合、ベースラインの配置方法を指定する要素を追加しようとすると、IllegalArgumentExceptionがスローされます。

    導入されたバージョン:
    1.6
    関連項目:
    GroupLayout.createParallelGroup(), GroupLayout.createBaselineGroup(boolean,boolean)

    • メソッドの詳細

      • addGroup

        public GroupLayout.ParallelGroup addGroup​(GroupLayout.Alignment alignment,
                                          GroupLayout.Group group)
        GroupをこのParallelGroupに指定された配置で追加します。 子がGroupより小さい場合、指定の配置方法に従って配置されます。
        パラメータ:
        alignment - 配置方法
        group - 追加するGroup
        戻り値:
        このParallelGroup
        例外:
        IllegalArgumentException - alignmentがnullである場合

      • addComponent

        public GroupLayout.ParallelGroup addComponent​(Component component,
                                              GroupLayout.Alignment alignment,
                                              int min,
                                              int pref,
                                              int max)
        このComponentをParallelGroupに指定の配置とサイズで追加します。
        パラメータ:
        alignment - 配置方法
        component - 追加するComponent
        min - 最小サイズ
        pref - 適切なサイズ
        max - 最大サイズ
        戻り値:
        このGroup
        例外:
        IllegalArgumentException - alignmentがnullである場合