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

クラスGroupLayout.ParallelGroup

java.lang.Object
javax.swing.GroupLayout.Group
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
関連項目:

  • メソッドの詳細

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