- 含まれているクラス:
- 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)
-
メソッドのサマリー
修飾子と型 メソッド 説明 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
に追加します。
-
メソッドの詳細
-
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
である場合
-