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 とおりの方法で子を配置します。

ベースライン

ベースラインに揃えて子を配置する 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, GroupLayout.Alignment alignment) Component をこの ParallelGroup に指定された配置で追加します。
GroupLayout.ParallelGroup	addComponent(Component component, GroupLayout.Alignment alignment, int min, int pref, int max) この Component を ParallelGroup に指定の配置とサイズで追加します。
GroupLayout.ParallelGroup	addComponent(Component component, int min, int pref, int max) Component をこの Group に指定されたサイズで追加します。
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 に追加します。

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細

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 である場合