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

クラス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つの考えられる方法で子を整列させます: ベースラインに沿って、中央揃え、先頭枠に固定されるか、または末尾にアンカーされます。

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
関連項目: