javax.swing

クラスSizeRequirements

java.lang.Object

javax.swing.SizeRequirements

すべての実装されたインタフェース:

Serializable

public class SizeRequirements
extends Object
implements Serializable

レイアウト・マネージャの便宜のために、コンポーネントのサイズと位置についての情報を計算します。サイズと位置のすべての計算メソッドは、SizeRequirementsの配列を引数として取得するクラス・メソッドです。SizeRequirementsクラスは2種類のレイアウトをサポートします。

tiled

コンポーネントは座標0 (左端または上端)から始まって両端揃えで配置されるか、あるいは割り当てられたスパンの端を表す座標(右端または下端)から始まって両端揃えで配置される。

aligned

コンポーネントはそれぞれの揃え方の値(XまたはY)に基づいて整列される。

各SizeRequirementsオブジェクトは、1つのコンポーネントまたは複数のコンポーネントの幅(とX揃え)または高さ(とY揃え)のどちらかについての情報を保持します。

minimum

コンポーネントまたはコンポーネント・グループの適度な最小の幅および高さ(ピクセル単位)。

preferred

コンポーネントまたはコンポーネント・グループの本来の幅および高さ(ピクセル単位)。

maximum

コンポーネントまたはコンポーネント・グループの適度な最大の幅および高さ(ピクセル単位)。

alignment

コンポーネントまたはコンポーネント・グループのXおよびY揃え。

警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースとの互換性がなくなる予定です。現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。1.4以降、すべてのJavaBeans(tm)用の長期間の格納サポートがjava.beansパッケージに追加されています。XMLEncoderを参照してください。

関連項目:

Component.getMinimumSize(), Component.getPreferredSize(), Component.getMaximumSize(), Component.getAlignmentX(), Component.getAlignmentY()

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
float	alignment 0.0と1.0の間の値(上下限値を含む)で指定される配置です。
int	maximum 可能な最大サイズです。
int	minimum 必要とされる最小サイズです。
int	preferred 適切な(本来の)サイズです。

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
SizeRequirements() 最小サイズ、適切なサイズ、最大サイズをゼロに、配置の値を0.5 (中央揃え)に設定して、SizeRequirementsオブジェクトを作成します。
SizeRequirements(int min, int pref, int max, float a) 指定された最小サイズ、適切なサイズ、最大サイズ、および配置で、SizeRequirementsオブジェクトを作成します。

メソッドのサマリー

修飾子と型	メソッドと説明
static int[]	adjustSizes(int delta, SizeRequirements[] children) 指定された量で、指定された配列のサイズを調整します。
static void	calculateAlignedPositions(int allocated, SizeRequirements total, SizeRequirements[] children, int[] offsets, int[] spans) コンポーネントのセットを指定の揃え方でレイアウトする方法を表す、多くのオフセット/スパンのペアを作成します。
static void	calculateAlignedPositions(int allocated, SizeRequirements total, SizeRequirements[] children, int[] offsets, int[] spans, boolean normal) コンポーネントのセットを指定の揃え方でレイアウトする方法を表す、多くのオフセット/スパンのペアを作成します。
static void	calculateTiledPositions(int allocated, SizeRequirements total, SizeRequirements[] children, int[] offsets, int[] spans) コンポーネントのセットを端から端までレイアウトする方法を表す、多くのオフセット/スパンのペアを作成します。
static void	calculateTiledPositions(int allocated, SizeRequirements total, SizeRequirements[] children, int[] offsets, int[] spans, boolean forward) コンポーネントのセットを端から端までレイアウトする方法を表す、多くのオフセット/スパンのペアを作成します。
static SizeRequirements	getAlignedSizeRequirements(SizeRequirements[] children) コンポーネントのセットを配置するのに必要な合計スペースを判定します。
static SizeRequirements	getTiledSizeRequirements(SizeRequirements[] children) コンポーネントのセットを端から端まで配置するのに必要な合計スペースを判定します。
String	toString() 最小サイズ、適切なサイズ、最大サイズの要件を記述する文字列を、配置と一緒に返します。

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

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

フィールドの詳細

minimum

public int minimum

必要とされる最小サイズです。コンポーネントcompでは、このサイズはcomp.getMinimumSize().widthまたはcomp.getMinimumSize().heightのどちらかに等しくなければいけません。

preferred

public int preferred

適切な(本来の)サイズです。コンポーネントcompでは、このサイズはcomp.getPreferredSize().widthまたはcomp.getPreferredSize().heightのどちらかに等しくなければいけません。

maximum

public int maximum

可能な最大サイズです。コンポーネントcompでは、このサイズはcomp.getMaximumSize().widthまたはcomp.getMaximumSize().heightのどちらかに等しくなければいけません。

alignment

public float alignment

0.0と1.0の間の値(上下限値を含む)で指定される配置です。中央揃えを指定するには、配置の値は0.5である必要があります。

コンストラクタの詳細

SizeRequirements

public SizeRequirements()

最小サイズ、適切なサイズ、最大サイズをゼロに、配置の値を0.5 (中央揃え)に設定して、SizeRequirementsオブジェクトを作成します。

SizeRequirements

public SizeRequirements(int min,
                        int pref,
                        int max,
                        float a)

指定された最小サイズ、適切なサイズ、最大サイズ、および配置で、SizeRequirementsオブジェクトを作成します。

パラメータ:

min - 最小サイズ>= 0

pref - 適切なサイズ>= 0

max - 最大サイズ>= 0

a - 配置>= 0.0f && <= 1.0f

メソッドの詳細

toString

public String toString()

最小サイズ、適切なサイズ、最大サイズの要件を記述する文字列を、配置と一緒に返します。

オーバーライド:

toString、クラス: Object

戻り値:

文字列

getTiledSizeRequirements

public static SizeRequirements getTiledSizeRequirements(SizeRequirements[] children)

コンポーネントのセットを端から端まで配置するのに必要な合計スペースを判定します。その各コンポーネントの必要事項は、渡されたSizeRequirements配列のエントリによって表現されます。返されたSizeRequirementsオブジェクトは、0.5 (中央揃え)という配置の値を持ちます。スペース要件は、Integer.MAX_VALUEより大きくはなりません。

パラメータ:

children - コンポーネントのセットのスペース要件。ベクトルの長さはゼロでもよく、その場合はデフォルトのSizeRequirementsオブジェクトのインスタンスが渡される。

戻り値:

合計スペースの要件。

getAlignedSizeRequirements

public static SizeRequirements getAlignedSizeRequirements(SizeRequirements[] children)

コンポーネントのセットを配置するのに必要な合計スペースを判定します。その各コンポーネントの必要事項は、渡されたSizeRequirements配列のエントリによって表現されます。必要な合計スペースは、Integer.MAX_VALUEより大きくはなりません。

パラメータ:

children - 子の要件のセット。長さが0の場合、SizeRequirementsのデフォルト・インスタンスが返される。

戻り値:

合計スペースの要件。

calculateTiledPositions

public static void calculateTiledPositions(int allocated,
                                           SizeRequirements total,
                                           SizeRequirements[] children,
                                           int[] offsets,
                                           int[] spans)

コンポーネントのセットを端から端までレイアウトする方法を表す、多くのオフセット/スパンのペアを作成します。このメソッドは、割当てスペース量の合計、配置する各コンポーネントのサイズ要件(SizeRequirementsの配列で指定される)、コンポーネント・セットの合計サイズの要件をユーザーが指定することを要求します。合計サイズの要件を取得するには、getTiledSizeRequirementsメソッドを呼び出します。コンポーネントは、0からオフセット分を増やしながら順方向にタイリングされます。

パラメータ:

allocated - 割り当てる合計スパン>= 0。

total - 子の要求の合計。この引数はオプションであり、nullの場合がある。

children - 各コンポーネントのサイズ要件。

offsets - スパンが割り当てられた各子の0からのオフセット(スパンの配置を指定する)。

spans - 各子に割り当てられたスパンで、合計ターゲット・スパンを構成する。

calculateTiledPositions

public static void calculateTiledPositions(int allocated,
                                           SizeRequirements total,
                                           SizeRequirements[] children,
                                           int[] offsets,
                                           int[] spans,
                                           boolean forward)

コンポーネントのセットを端から端までレイアウトする方法を表す、多くのオフセット/スパンのペアを作成します。このメソッドは、割当てスペース量の合計、配置する各コンポーネントのサイズ要件(SizeRequirementsの配列で指定される)、コンポーネント・セットの合計サイズの要件をユーザーが指定することを要求します。合計サイズの要件を取得するには、getTiledSizeRequirementsメソッドを呼び出します。このメソッドでは、コンポーネントを順方向に(0からオフセット分増やしながら)タイリングするか、逆方向に(割当てスペースの端からオフセット分減らしながら)タイリングするかをフラグで指定する必要があります。順方向は、コンポーネントを左から右または上から下にタイリングすることを表し、逆方向は、コンポーネントを右から左または下から上にタイリングすることを表します。

パラメータ:

allocated - 割り当てる合計スパン>= 0。

total - 子の要求の合計。この引数はオプションであり、nullの場合がある。

children - 各コンポーネントのサイズ要件。

offsets - スパンが割り当てられた各子の0からのオフセット(スパンの配置を指定する)。

spans - 各子に割り当てられたスパンで、合計ターゲット・スパンを構成する。

forward - trueの場合、0からオフセット分増やしながらタイリングし、falseの場合、割当てスペースの端からオフセット分減らしながらタイリングする。

導入されたバージョン:

1.4

calculateAlignedPositions

public static void calculateAlignedPositions(int allocated,
                                             SizeRequirements total,
                                             SizeRequirements[] children,
                                             int[] offsets,
                                             int[] spans)

コンポーネントのセットを指定の揃え方でレイアウトする方法を表す、多くのオフセット/スパンのペアを作成します。結果として得られるスパン割当ては、指定の合計割当てにそれぞれが収まるか可能なかぎり収まる状態でオーバーラップします。このメソッドは、割当てスペース量の合計、配置する各コンポーネントのサイズ要件(SizeRequirementsの配列で指定される)、コンポーネント・セットの合計サイズの要件(実際に使用される配置フィールドだけ)をユーザーが指定することを要求します。合計サイズの要件を取得するには、getAlignedSizeRequirementsメソッドを呼び出します。通常の配置は、配置の値を0.0f (コンポーネントの左上端を表す)に設定して実行されます。

パラメータ:

allocated - 割り当てる合計スパン>= 0。

total - 子の要求の合計。

children - 各コンポーネントのサイズ要件。

offsets - スパンが割り当てられた各子の0からのオフセット(スパンの配置を指定する)。

spans - 各子に割り当てられたスパンで、合計ターゲット・スパンを構成する。

calculateAlignedPositions

public static void calculateAlignedPositions(int allocated,
                                             SizeRequirements total,
                                             SizeRequirements[] children,
                                             int[] offsets,
                                             int[] spans,
                                             boolean normal)

コンポーネントのセットを指定の揃え方でレイアウトする方法を表す、多くのオフセット/スパンのペアを作成します。結果として得られるスパン割当ては、指定の合計割当てにそれぞれが収まるか可能なかぎり収まる状態でオーバーラップします。このメソッドは、割当てスペース量の合計、配置する各コンポーネントのサイズ要件(SizeRequirementsの配列で指定される)、コンポーネント・セットの合計サイズの要件(実際に使用される配置フィールドだけ)をユーザーが指定することを要求します。合計サイズの要件を取得するには、getAlignedSizeRequirementsメソッドを呼び出します。このメソッドでは、通常の配置と逆の配置のどちらを行うかをフラグで指定します。通常の配置の値0.0fは配置するコンポーネントの左上端を表し、逆の配置の0.0fは右下端を表します。

パラメータ:

allocated - 割り当てる合計スパン>= 0。

total - 子の要求の合計。

children - 各コンポーネントのサイズ要件。

offsets - スパンが割り当てられた各子の0からのオフセット(スパンの配置を指定する)。

spans - 各子に割り当てられたスパンで、合計ターゲット・スパンを構成する。

normal - trueの場合、配置の値0.0fは左上端を示し、falseの場合は右下端を示す。

導入されたバージョン:

1.4

adjustSizes

public static int[] adjustSizes(int delta,
                                SizeRequirements[] children)

指定された量で、指定された配列のサイズを調整します。

パラメータ:

delta - サイズの差を表すint値

children - SizeRequirementsオブジェクトの配列

戻り値:

各項目の最終サイズが格納されているintの配列