クラスGroupLayout.ParallelGroup

java.lang.Object
javax.swing.GroupLayout.Group
javax.swing.GroupLayout.ParallelGroup
含まれているクラス:
GroupLayout
public sealed class GroupLayout.ParallelGroup extends GroupLayout.Group
子を調整およびサイズ調整するGroup。 ParallelGroupは4つの考えられる方法で子を整列させます: ベースラインに沿って、中央揃え、先頭枠に固定されるか、または末尾にアンカーされます。

ベースライン

ベースラインに沿って子を配置する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.ParallelGroup
    addComponent(Component component)
    ComponentをこのGroupに追加します。
    GroupLayout.ParallelGroup
    addComponent(Component component, int min, int pref, int max)
    ComponentをこのGroupに指定されたサイズで追加します。
    GroupLayout.ParallelGroup
    addComponent(Component component, GroupLayout.Alignment alignment)
    ComponentをこのParallelGroupに指定された配置で追加します。
    GroupLayout.ParallelGroup
    addComponent(Component component, GroupLayout.Alignment alignment, int min, int pref, int max)
    このComponentをParallelGroupに指定の配置とサイズで追加します。
    GroupLayout.ParallelGroup
    addGap(int pref)
    このGroupに固定のギャップを追加します。
    GroupLayout.ParallelGroup
    addGap(int min, int pref, int max)
    指定のサイズで、このGroupにギャップを追加します。
    GroupLayout.ParallelGroup
    addGroup(GroupLayout.Alignment alignment, GroupLayout.Group group)
    GroupをこのParallelGroupに指定された配置で追加します。
    GroupLayout.ParallelGroup
    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.ParallelGroup addGroup(GroupLayout.Group group)
      GroupをこのGroupに追加します。
      オーバーライド:
      addGroup、クラスGroupLayout.Group
      パラメータ:
      group - 追加するGroup
      戻り値:
      このGroup

    • addComponent

      public GroupLayout.ParallelGroup addComponent(Component component)
      ComponentをこのGroupに追加します。
      オーバーライド:
      addComponent、クラスGroupLayout.Group
      パラメータ:
      component - 追加するComponent
      戻り値:
      このGroup

    • addComponent

      public GroupLayout.ParallelGroup addComponent(Component component, int min, int pref, int max)
      ComponentをこのGroupに指定されたサイズで追加します。
      オーバーライド:
      addComponent、クラスGroupLayout.Group
      パラメータ:
      component - 追加するComponent
      min - 最小サイズ、またはDEFAULT_SIZEかPREFERRED_SIZE
      pref - 推奨サイズ、またはDEFAULT_SIZEかPREFERRED_SIZE
      max - 最大サイズ、またはDEFAULT_SIZEかPREFERRED_SIZE
      戻り値:
      このGroup

    • addGap

      public GroupLayout.ParallelGroup addGap(int pref)
      このGroupに固定のギャップを追加します。
      オーバーライド:
      addGap、クラスGroupLayout.Group
      パラメータ:
      pref - ギャップのサイズ
      戻り値:
      このGroup

    • addGap

      public GroupLayout.ParallelGroup addGap(int min, int pref, int max)
      指定のサイズで、このGroupにギャップを追加します。
      オーバーライド:
      addGap、クラスGroupLayout.Group
      パラメータ:
      min - ギャップの最小サイズ
      pref - ギャップの推奨サイズ
      max - ギャップの最大サイズ
      戻り値:
      このGroup

    • 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)
      ComponentをこのParallelGroupに指定された配置で追加します。
      パラメータ:
      component - 追加するComponent
      alignment - 配置方法
      戻り値:
      このGroup
      スロー:
      IllegalArgumentException - alignmentがnullである場合

    • addComponent

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