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