- java.lang.Object
-
- java.awt.GridBagLayout
-
- すべての実装されたインタフェース:
LayoutManager
,LayoutManager2
,Serializable
public class GridBagLayout extends Object implements LayoutManager2, Serializable
GridBagLayout
クラスは、コンポーネントが同じサイズであることを要求することなく、コンポーネントを垂直方向に、水平方向に、またはベースラインに沿って配置する柔軟なレイアウト・マネージャです。 それぞれのGridBagLayout
オブジェクトは、セルによって構成される動的な矩形グリッドを格納しています。各コンポーネントは、1つ以上のセル(表示領域と呼ぶ)に配置されます。GridBagLayout
によって管理される各コンポーネントは、GridBagConstraints
のインスタンスと関連します。 制約オブジェクトは、コンポーネントの表示領域をグリッド上に配置する場所、およびコンポーネントをその表示領域内に配置する方法を指定します。 また、この制約オブジェクトに加え、GridBagLayout
は、コンポーネントのサイズを決定するために、各コンポーネントの最小サイズおよび推奨サイズを考慮します。グリッドの全体の方向は、コンテナの
ComponentOrientation
プロパティによって決まります。 水平方向に左から右の場合、グリッドの座標(0, 0)はコンテナの左上隅になります。この場合、X座標は右方向に、Y座標は下方向に値が増加します。 水平方向に右から左の場合、グリッドの座標(0, 0)はコンテナの右上隅になります。この場合、X座標は左方向に、Y座標は下方向に値が増加します。グリッド・バッグ・レイアウトを効果的に利用するには、コンポーネントの少なくとも1つの
GridBagConstraints
オブジェクトをカスタマイズする必要があります。GridBagConstraints
オブジェクトをカスタマイズするには、1つまたは複数のインスタンス変数を設定します。GridBagConstraints.gridx
,GridBagConstraints.gridy
- コンポーネントの表示領域のリーディング・コーナーを格納するセルを指定します。グリッドの原点にあるセルのアドレスは
gridx = 0
、gridy = 0
です。 水平方向に左から右へのレイアウトの場合、コンポーネントのリーディング・コーナーは左上隅です。 水平方向に右から左へのレイアウトの場合、コンポーネントのリーディング・コーナーは右上隅です。GridBagConstraints.RELATIVE
(デフォルト値)を使用して、コンポーネントを、このコンポーネントが追加される直前にコンテナに追加されたコンポーネントの直後に(gridx
はx軸に沿って、gridy
はy軸に沿って)配置するよう指定します。 GridBagConstraints.gridwidth
,GridBagConstraints.gridheight
- コンポーネントの表示領域における1行(
gridwidth
)または1列(gridheight
)あたりのセルの数を指定します。 デフォルト値は1です。 コンポーネントの表示領域がgridx
から行の最後のセルまで(gridwidth
)またはgridy
から列の最後のセルまで(gridheight
)であることを指定する場合は、GridBagConstraints.REMAINDER
を使用します。 コンポーネントの表示領域がgridx
から、行の最後から2番目のセルまで(gridwidth
)、またはgridy
から、列の最後から2番目のセルまで(gridheight
)であることを指定する場合は、GridBagConstraints.RELATIVE
を使用します。 GridBagConstraints.fill
- コンポーネントの表示領域が、必要とするサイズよりも大きい場合には、コンポーネントのサイズ変更を行うかどうかと変更の方法を決定するために使用されます。 指定できる値は、
GridBagConstraints.NONE
(デフォルト)、GridBagConstraints.HORIZONTAL
(コンポーネントの高さは変更せずに、幅を表示領域最大にする)、GridBagConstraints.VERTICAL
(コンポーネントの幅は変更せずに、高さを表示領域最大にする)、GridBagConstraints.BOTH
(コンポーネントを表示領域最大にする)です。 GridBagConstraints.ipadx
,GridBagConstraints.ipady
- レイアウト内のコンポーネントの内側のパディング(コンポーネントの最小サイズに追加する値)を指定します。 コンポーネントの幅は、少なくとも最小の幅+
ipadx
ピクセルとなります。 同様に、コンポーネントの高さは、少なくとも最小の高さ+ipady
ピクセルとなります。 GridBagConstraints.insets
- コンポーネントの外側のパディング、つまりコンポーネントと表示領域の端との間の最小の空間を指定します。
GridBagConstraints.anchor
- 表示領域内のコンポーネントの位置を指定します。 取り得る値には、絶対値、方向相対値、ベースライン相対値の3種類があります。方向相対値はコンテナの
ComponentOrientation
プロパティを基準にして解釈されますが、絶対値には解釈はありません。 ベースライン相対値は、ベースラインを基準にして計算されます。 有効な値は次のとおりです。上記の絶対値、相対値、ベースライン値 絶対値
方向相対値
ベースライン相対値
GridBagConstraints.NORTH
GridBagConstraints.SOUTH
GridBagConstraints.WEST
GridBagConstraints.EAST
GridBagConstraints.NORTHWEST
GridBagConstraints.NORTHEAST
GridBagConstraints.SOUTHWEST
GridBagConstraints.SOUTHEAST
GridBagConstraints.CENTER
(デフォルト)
GridBagConstraints.PAGE_START
GridBagConstraints.PAGE_END
GridBagConstraints.LINE_START
GridBagConstraints.LINE_END
GridBagConstraints.FIRST_LINE_START
GridBagConstraints.FIRST_LINE_END
GridBagConstraints.LAST_LINE_START
GridBagConstraints.LAST_LINE_END
GridBagConstraints.BASELINE
GridBagConstraints.BASELINE_LEADING
GridBagConstraints.BASELINE_TRAILING
GridBagConstraints.ABOVE_BASELINE
GridBagConstraints.ABOVE_BASELINE_LEADING
GridBagConstraints.ABOVE_BASELINE_TRAILING
GridBagConstraints.BELOW_BASELINE
GridBagConstraints.BELOW_BASELINE_LEADING
GridBagConstraints.BELOW_BASELINE_TRAILING
GridBagConstraints.weightx
,GridBagConstraints.weighty
- スペースの分配方法を決定するために使用されます。これは、サイズ変更の動作を指定するために重要です。 1行(
weightx
)または1列(weighty
)につき、少なくとも1つのコンポーネントにウエイトを設定しないかぎり、すべてのコンポーネントがコンテナの中央に集まります。 これは、ウエイトが0の場合(デフォルト)には、GridBagLayout
オブジェクトが余分なスペースをすべてセルのグリッドとコンテナの端の間に配置してしまうからです。
各行にはベースラインがあります; ベースラインは、その行の有効なベースラインを持ち、ベースライン(コンポーネントのアンカー値は、
BASELINE
、BASELINE_LEADING
またはBASELINE_TRAILING
のいずれかです)に沿って整列されたコンポーネントによって決まります。 行内でいずれのコンポーネントも有効なベースラインを持たない場合、その行にベースラインはありません。複数の行にまたがるようなコンポーネントは、開始行のベースライン(ベースライン・サイズ変更動作が
CONSTANT_ASCENT
の場合)、または終了行のベースライン(ベースライン・サイズ変更動作がCONSTANT_DESCENT
の場合)に沿って配置されます。 コンポーネントが沿う行は、支配行と呼ばれます。次の図に、ベースラインのレイアウトを示します。この図では複数行にまたがるコンポーネントが存在します。
ベースラインのレイアウト - 行0から始まり、行1で終わるパネル。 パネルにはベースライン・サイズ変更動作
CONSTANT_DESCENT
とアンカーBASELINE
が設定されています。 ベースライン・サイズ変更動作がCONSTANT_DESCENT
であるため、パネルの支配行は行1です。 - 2つのボタン。それぞれベースライン・サイズ変更動作
CENTER_OFFSET
とアンカーBASELINE
が設定されています。
ベースライン相対値のいずれかを使用して配置されたコンポーネントは、絶対値または方向相対値を使用して配置した場合と異なる方法でサイズが変更されます。 コンポーネントの変更方法は、支配行のベースラインの変更方法によって指示されます。 同じ支配行を持つ任意のコンポーネントでベースライン・サイズ変更動作
CONSTANT_DESCENT
が設定されている場合、ベースラインは表示領域の下端にアンカー設定されます。そうでない場合、ベースラインは表示領域の上端にアンカー設定されます。 次のルールによってサイズ変更動作が指示されます。- ベースラインより上に配置されたサイズ変更可能コンポーネントは、ベースラインと同じ高さまでしか高くすることはできません。 たとえばベースラインが100で、上端にアンカー設定されている場合、ベースラインより上に配置されたサイズ変更可能コンポーネントは100単位よりも高くすることはできません。
- 同様に、ベースラインより下に配置されたサイズ変更可能コンポーネントは、表示高さとベースラインの間隔よりも高くすることはできません。
- ベースラインに配置され、ベースライン・サイズ変更動作
OTHER
が設定されたサイズ変更可能コンポーネントの場合は、サイズ変更後のサイズのベースラインが表示領域に収まる場合に限り、サイズ変更されます。 ベースラインが表示領域内に収まらなくなる場合、コンポーネントはサイズ変更されません。 - ベースライン・サイズ変更動作が
OTHER
ではないベースラインに配置されたコンポーネントは、display height - baseline+baseline of component
まで高くすることができます。
次に示す図は、グリッド・バッグ・レイアウトによって管理される10個のコンポーネント(すべてのボタン)を示します。 図2は水平方向に左から右へのコンテナを示し、図3は水平方向に右から左へのコンテナを示します。
図2: 水平方向に左から右 図3: 水平方向に右から左 10個のコンポーネントのそれぞれは、その関連している
GridBagConstraints
オブジェクトのfill
フィールドがGridBagConstraints.BOTH
に設定されています。 さらにコンポーネントは、デフォルトとは異なる次の制約を持っています。- Button1、Button2、Button3:
weightx = 1.0
- Button4:
weightx = 1.0
,gridwidth = GridBagConstraints.REMAINDER
- Button5:
gridwidth = GridBagConstraints.REMAINDER
- Button6:
gridwidth = GridBagConstraints.RELATIVE
- Button7:
gridwidth = GridBagConstraints.REMAINDER
- Button8:
gridheight = 2
,weighty = 1.0
- Button9、Button 10:
gridwidth = GridBagConstraints.REMAINDER
上記の例を実装したサンプル・コードを示します。
import java.awt.*; import java.util.*; import java.applet.Applet; public class GridBagEx1 extends Applet { protected void makebutton(String name, GridBagLayout gridbag, GridBagConstraints c) { Button button = new Button(name); gridbag.setConstraints(button, c); add(button); } public void init() { GridBagLayout gridbag = new GridBagLayout(); GridBagConstraints c = new GridBagConstraints(); setFont(new Font("SansSerif", Font.PLAIN, 14)); setLayout(gridbag); c.fill = GridBagConstraints.BOTH; c.weightx = 1.0; makebutton("Button1", gridbag, c); makebutton("Button2", gridbag, c); makebutton("Button3", gridbag, c); c.gridwidth = GridBagConstraints.REMAINDER; //end row makebutton("Button4", gridbag, c); c.weightx = 0.0; //reset to the default makebutton("Button5", gridbag, c); //another row c.gridwidth = GridBagConstraints.RELATIVE; //next-to-last in row makebutton("Button6", gridbag, c); c.gridwidth = GridBagConstraints.REMAINDER; //end row makebutton("Button7", gridbag, c); c.gridwidth = 1; //reset to the default c.gridheight = 2; c.weighty = 1.0; makebutton("Button8", gridbag, c); c.weighty = 0.0; //reset to the default c.gridwidth = GridBagConstraints.REMAINDER; //end row c.gridheight = 1; //reset to the default makebutton("Button9", gridbag, c); makebutton("Button10", gridbag, c); setSize(300, 100); } public static void main(String args[]) { Frame f = new Frame("GridBag Layout Example"); GridBagEx1 ex1 = new GridBagEx1(); ex1.init(); f.add("Center", ex1); f.pack(); f.setSize(f.getPreferredSize()); f.show(); } }
- 導入されたバージョン:
- 1.0
- 関連項目:
GridBagConstraints
,GridBagLayoutInfo
,ComponentOrientation
, 直列化された形式
-
-
フィールドのサマリー
フィールド 修飾子と型 フィールド 説明 double[]
columnWeights
このフィールドは、列のウエイトに対するオーバーライドを保持します。int[]
columnWidths
このフィールドは、列の最小幅に対するオーバーライドを保持します。protected Hashtable<Component,GridBagConstraints>
comptable
このハッシュ表は、コンポーネントとコンポーネントのグリッド・バッグ制約との関連性を維持します。protected GridBagConstraints
defaultConstraints
このフィールドには、デフォルト値を含むグリッド・バッグ制約のインスタンスが保持されているため、コンポーネントにグリッド・バッグ制約が関連付けられていない場合、そのコンポーネントにはdefaultConstraints
のコピーが割り当てられます。protected GridBagLayoutInfo
layoutInfo
このフィールドは、グリッド・バッグのレイアウト情報を保持します。protected static int
MAXGRIDSIZE
このフィールドは、配列を予約するためには使用されなくなり、下位互換性のために維持されています。protected static int
MINSIZE
グリッド・バッグ・レイアウトによって配置できる最小のグリッドです。protected static int
PREFERREDSIZE
グリッド・バッグ・レイアウトによって配置できるグリッドの推奨サイズです。int[]
rowHeights
このフィールドは、行の最小の高さに対するオーバーライドを保持します。double[]
rowWeights
このフィールドは、行のウエイトに対するオーバーライドを保持します。
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 GridBagLayout()
グリッド・バッグ・レイアウト・マネージャを作成します。
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 具象メソッド 修飾子と型 メソッド 説明 void
addLayoutComponent(Component comp, Object constraints)
指定されたconstraints
オブジェクトを使用して、指定されたコンポーネントをレイアウトに追加します。void
addLayoutComponent(String name, Component comp)
このレイアウト・マネージャはコンポーネントごとの文字列を使用しないため、何もしません。protected void
adjustForGravity(GridBagConstraints constraints, Rectangle r)
x、y、幅、高さフィールドを、制約幾何学的図形およびパッドに応じて正しい値に調整します。protected void
AdjustForGravity(GridBagConstraints constraints, Rectangle r)
x、y、幅、高さフィールドを、制約幾何学的図形およびパッドに応じて正しい値に調整します。protected void
arrangeGrid(Container parent)
グリッドを配置します。protected void
ArrangeGrid(Container parent)
このメソッドは廃止されており、下位互換性のためにのみ提供されています。新しいコードは、かわりにarrangeGrid
を呼び出すようにしてください。GridBagConstraints
getConstraints(Component comp)
指定されたコンポーネントの制約を返します。float
getLayoutAlignmentX(Container parent)
x軸方向の配置を返します。float
getLayoutAlignmentY(Container parent)
y軸方向の配置を返します。int[][]
getLayoutDimensions()
レイアウト・グリッドの列の幅と行の高さを指定します。protected GridBagLayoutInfo
getLayoutInfo(Container parent, int sizeflag)
管理される子の現在のセットに対するGridBagLayoutInfo
のインスタンスに値を入力します。protected GridBagLayoutInfo
GetLayoutInfo(Container parent, int sizeflag)
このメソッドは廃止されており、下位互換性のためにのみ提供されています。新しいコードは、かわりにgetLayoutInfo
を呼び出すようにしてください。Point
getLayoutOrigin()
ターゲット・コンテナのグラフィックス座標空間内で、レイアウト領域の原点を指定します。double[][]
getLayoutWeights()
レイアウト・グリッドの列と行のウエイトを指定します。protected Dimension
getMinSize(Container parent, GridBagLayoutInfo info)
getLayoutInfo
の情報に基づいて、親の最小サイズを示します。protected Dimension
GetMinSize(Container parent, GridBagLayoutInfo info)
このメソッドは廃止されており、下位互換性のためにのみ提供されています。新しいコードは、かわりにgetMinSize
を呼び出すようにしてください。void
invalidateLayout(Container target)
レイアウトを無効にします。このとき、レイアウト・マネージャが情報をキャッシュしていればそれを破棄します。void
layoutContainer(Container parent)
このグリッド・バッグ・レイアウトを使って指定されたコンテナを配置します。Point
location(int x, int y)
(x, y)
によって指定された点がレイアウト・グリッド内のどのセルに含まれているかを判定します。protected GridBagConstraints
lookupConstraints(Component comp)
指定されたコンポーネントの制約を返します。Dimension
maximumLayoutSize(Container target)
指定されたターゲット・コンテナにコンポーネントが与えられた場合の、レイアウトの最大サイズを返します。Dimension
minimumLayoutSize(Container parent)
このグリッド・バッグ・レイアウトを使用して、parent
コンテナの最小サイズを判定します。Dimension
preferredLayoutSize(Container parent)
このグリッド・バッグ・レイアウトを使用して、parent
コンテナの優先サイズを判定します。void
removeLayoutComponent(Component comp)
指定されたコンポーネントをこのレイアウトから削除します。void
setConstraints(Component comp, GridBagConstraints constraints)
このレイアウトの指定されたコンポーネントに対して制約を設定します。String
toString()
グリッド・バッグ・レイアウトの値の文字列表現を返します。
-
-
-
フィールドの詳細
-
MAXGRIDSIZE
protected static final int MAXGRIDSIZE
このフィールドは、配列を予約するためには使用されなくなり、下位互換性のために維持されています。 以前は、グリッド・バッグ・レイアウトによって配置できるグリッド位置(縦横どちらとも)の最大数でした。 現在の実装では、グリッド・サイズに制限はありません。- 関連項目:
- 定数フィールド値
-
MINSIZE
protected static final int MINSIZE
グリッド・バッグ・レイアウトによって配置できる最小のグリッドです。- 関連項目:
- 定数フィールド値
-
PREFERREDSIZE
protected static final int PREFERREDSIZE
グリッド・バッグ・レイアウトによって配置できるグリッドの推奨サイズです。- 関連項目:
- 定数フィールド値
-
comptable
protected Hashtable<Component,GridBagConstraints> comptable
このハッシュ表は、コンポーネントとコンポーネントのグリッド・バッグ制約との関連性を維持します。comptable
内のキーはコンポーネントで、値はGridBagConstraints
のインスタンスです。- 関連項目:
GridBagConstraints
-
defaultConstraints
protected GridBagConstraints defaultConstraints
このフィールドには、デフォルト値を含むグリッド・バッグ制約のインスタンスが保持されているため、コンポーネントにグリッド・バッグ制約が関連付けられていない場合、そのコンポーネントにはdefaultConstraints
のコピーが割り当てられます。
-
layoutInfo
protected GridBagLayoutInfo layoutInfo
このフィールドは、グリッド・バッグのレイアウト情報を保持します。 このフィールドの情報は、グリッド・バッグの最新の検査に基づきます。layoutInfo
がnull
の場合は、グリッド・バッグにコンポーネントがないか、またはコンポーネントがあってもそれがまだ検査を受けていないことを意味します。
-
columnWidths
public int[] columnWidths
このフィールドは、列の最小幅に対するオーバーライドを保持します。 このフィールドがnull
ではない場合、すべての最小列幅が計算されたあとで、その値がグリッド・バッグに適用されます。 columnWidthsに列数より多くの要素がある場合、columnWidthの要素数に合わせるためにグリッド・バッグに列が追加されます。- 関連項目:
getLayoutDimensions()
-
rowHeights
public int[] rowHeights
このフィールドは、行の最小の高さに対するオーバーライドを保持します。 このフィールドがnull
ではない場合、すべての最小の行の高さが計算されたあとで、その値がグリッド・バッグに適用されます。rowHeights
に行数より多くの要素がある場合、rowHeights
の要素数に合わせるために、グリッド・バッグに行が追加されます。- 関連項目:
getLayoutDimensions()
-
columnWeights
public double[] columnWeights
このフィールドは、列のウエイトに対するオーバーライドを保持します。 このフィールドがnull
ではない場合、すべての列のウエイトが計算されたあとで、その値がグリッド・バッグに適用されます。 列iのcolumnWeights[i] >
の重みがcolumnWeights[i]
の重みに割り当てられると、列iには重みが割り当てられます。columnWeights
に列数より多くの要素がある場合、超過した要素は無視され、列の作成は行われません。
-
rowWeights
public double[] rowWeights
このフィールドは、行のウエイトに対するオーバーライドを保持します。 このフィールドがnull
ではない場合、すべての行のウエイトが計算されたあとで、その値がグリッド・バッグに適用されます。 行iのrowWeights[i] >
の重みの場合、rowWeights[i]
の重みに行iが割り当てられます。rowWeights
に行数より多くの要素がある場合、超過した要素は無視され、行の作成は行われません。
-
-
メソッドの詳細
-
setConstraints
public void setConstraints(Component comp, GridBagConstraints constraints)
このレイアウトの指定されたコンポーネントに対して制約を設定します。- パラメータ:
comp
- 変更されるコンポーネントconstraints
- 適用される制約
-
getConstraints
public GridBagConstraints getConstraints(Component comp)
指定されたコンポーネントの制約を返します。 実際のGridBagConstraints
オブジェクトのコピーが返されます。- パラメータ:
comp
- 照会されるコンポーネント- 戻り値:
- このグリッド・バッグ・レイアウトで指定されたコンポーネントの制約、つまり実際の制約オブジェクトのコピーが返される
-
lookupConstraints
protected GridBagConstraints lookupConstraints(Component comp)
指定されたコンポーネントの制約を返します。 戻り値はコピーではなく、配置メカニズムで使用される実際のGridBagConstraints
オブジェクトです。comp
がGridBagLayout
にない場合、一連のデフォルトのGridBagConstraints
が返されます。null
のcomp
値は無効で、null
が返されます。- パラメータ:
comp
- 照会されるコンポーネント- 戻り値:
- 指定されたコンポーネントの制約
-
getLayoutOrigin
public Point getLayoutOrigin()
ターゲット・コンテナのグラフィックス座標空間内で、レイアウト領域の原点を指定します。 この値はコンテナのComponentOrientation
の値とは関係なく、レイアウト領域の左上隅のピクセル座標を表します。 これは、セル座標(0,0)によって指定されるグリッドの原点とは異なります。 ほとんどのアプリケーションはこのメソッドを直接には呼び出しません。- 戻り値:
- レイアウト・グリッドの左上隅にあるセルのグラフィックスの原点
- 導入されたバージョン:
- 1.1
- 関連項目:
ComponentOrientation
-
getLayoutDimensions
public int[][] getLayoutDimensions()
レイアウト・グリッドの列の幅と行の高さを指定します。ほとんどのアプリケーションはこのメソッドを直接には呼び出しません。
- 戻り値:
- レイアウト列の幅とレイアウト行の高さを格納する、2つの配列から構成される配列
- 導入されたバージョン:
- 1.1
-
getLayoutWeights
public double[][] getLayoutWeights()
レイアウト・グリッドの列と行のウエイトを指定します。 ウエイトを使うと、レイアウトに余分な空きスペースがある場合に、指定された列または行をその推奨サイズよりどれだけ拡大できるかを計算できます。ほとんどのアプリケーションはこのメソッドを直接には呼び出しません。
- 戻り値:
- レイアウト列の水平のウエイトとレイアウト行の垂直のウエイトを表現する、2つの配列から構成される配列
- 導入されたバージョン:
- 1.1
-
location
public Point location(int x, int y)
(x, y)
によって指定された点がレイアウト・グリッド内のどのセルに含まれているかを判定します。 各セルは列インデックス(0から列数 - 1)と行インデックス(0から行数 - 1)で識別されます。点
(x, y)
がグリッドの外側にある場合、次のルールが適用されます。x
が左から右方向のコンテナのレイアウトの左にある場合、または右から左方向のコンテナのレイアウトの右にある場合、列インデックスはゼロが返されます。x
が左から右方向のコンテナのレイアウトの右にある場合、または右から左方向のコンテナのレイアウトの左にある場合、列インデックスは列数が返されます。y
がレイアウトの上にある場合は、行インデックスはゼロが返され、y
がレイアウトの下にある場合は、行数が返されます。 コンテナの方向は、そのComponentOrientation
プロパティによって指定されます。- パラメータ:
x
- 点のx座標y
- 点のy座標- 戻り値:
- レイアウト・グリッドのどのセルが点(x, y)を格納しているかを示す順序付きペアのインデックス。
- 導入されたバージョン:
- 1.1
- 関連項目:
ComponentOrientation
-
addLayoutComponent
public void addLayoutComponent(String name, Component comp)
このレイアウト・マネージャはコンポーネントごとの文字列を使用しないため、何もしません。- 定義:
addLayoutComponent
、インタフェースLayoutManager
- パラメータ:
name
- コンポーネントに関連付けられる文字列comp
- 追加されるコンポーネント
-
addLayoutComponent
public void addLayoutComponent(Component comp, Object constraints)
指定されたconstraints
オブジェクトを使用して、指定されたコンポーネントをレイアウトに追加します。 制約は可変であり、そのためキャッシュ時に複製されることに注意します。- 定義:
addLayoutComponent
、インタフェースLayoutManager2
- パラメータ:
comp
- 追加されるコンポーネントconstraints
- コンポーネントをレイアウトに追加する方法を指定するオブジェクト- 例外:
IllegalArgumentException
-constraints
がGridBagConstraint
ではない場合
-
removeLayoutComponent
public void removeLayoutComponent(Component comp)
指定されたコンポーネントをこのレイアウトから削除します。ほとんどのアプリケーションはこのメソッドを直接には呼び出しません。
- 定義:
removeLayoutComponent
、インタフェースLayoutManager
- パラメータ:
comp
- 削除されるコンポーネント。- 関連項目:
Container.remove(java.awt.Component)
,Container.removeAll()
-
preferredLayoutSize
public Dimension preferredLayoutSize(Container parent)
このグリッド・バッグ・レイアウトを使用して、parent
コンテナの優先サイズを判定します。ほとんどのアプリケーションはこのメソッドを直接には呼び出しません。
- 定義:
preferredLayoutSize
、インタフェースLayoutManager
- パラメータ:
parent
- レイアウトが行われるコンテナ- 戻り値:
parent
コンテナの推奨サイズ- 関連項目:
Container.getPreferredSize()
-
minimumLayoutSize
public Dimension minimumLayoutSize(Container parent)
このグリッド・バッグ・レイアウトを使用して、parent
コンテナの最小サイズを判定します。ほとんどのアプリケーションはこのメソッドを直接には呼び出しません。
- 定義:
minimumLayoutSize
、インタフェースLayoutManager
- パラメータ:
parent
- レイアウトが行われるコンテナ- 戻り値:
parent
コンテナの最小サイズ- 関連項目:
Container.doLayout()
-
maximumLayoutSize
public Dimension maximumLayoutSize(Container target)
指定されたターゲット・コンテナにコンポーネントが与えられた場合の、レイアウトの最大サイズを返します。- 定義:
maximumLayoutSize
、インタフェースLayoutManager2
- パラメータ:
target
- 配置する必要があるコンテナ- 戻り値:
- このレイアウトの最大サイズ
- 関連項目:
Container
,minimumLayoutSize(Container)
,preferredLayoutSize(Container)
-
getLayoutAlignmentX
public float getLayoutAlignmentX(Container parent)
x軸方向の配置を返します。 これは、そのコンポーネントがほかのコンポーネントに対してどのように配置されるべきかを指定したものです。 この値は0から1の間の数値で、0は原点に沿った配置を表し、1は原点からもっとも遠いところに、0.5は中央に配置されます。- 定義:
getLayoutAlignmentX
、インタフェースLayoutManager2
- パラメータ:
parent
- ターゲット・コンテナ- 戻り値:
- 中央への配置を示す値
0.5f
-
getLayoutAlignmentY
public float getLayoutAlignmentY(Container parent)
y軸方向の配置を返します。 これは、そのコンポーネントがほかのコンポーネントに対してどのように配置されるべきかを指定したものです。 この値は0から1の間の数値で、0は原点に沿った配置を表し、1は原点からもっとも遠いところに、0.5は中央に配置されます。- 定義:
getLayoutAlignmentY
、インタフェースLayoutManager2
- パラメータ:
parent
- ターゲット・コンテナ- 戻り値:
- 中央への配置を示す値
0.5f
-
invalidateLayout
public void invalidateLayout(Container target)
レイアウトを無効にします。このとき、レイアウト・マネージャが情報をキャッシュしていればそれを破棄します。- 定義:
invalidateLayout
、インタフェースLayoutManager2
- パラメータ:
target
- ターゲット・コンテナ
-
layoutContainer
public void layoutContainer(Container parent)
このグリッド・バッグ・レイアウトを使って指定されたコンテナを配置します。 このメソッドはこのGridBagLayout
オブジェクトの制約を満たすために、指定されたコンテナ内のコンポーネントの形状を変更します。ほとんどのアプリケーションはこのメソッドを直接には呼び出しません。
- 定義:
layoutContainer
、インタフェースLayoutManager
- パラメータ:
parent
- レイアウトが行われるコンテナ- 関連項目:
Container
,Container.doLayout()
-
toString
public String toString()
グリッド・バッグ・レイアウトの値の文字列表現を返します。
-
getLayoutInfo
protected GridBagLayoutInfo getLayoutInfo(Container parent, int sizeflag)
管理される子の現在のセットに対するGridBagLayoutInfo
のインスタンスに値を入力します。 このインスタンスには、子のセットを通じて、次の3つの段階の実行が必要です。- レイアウト・グリッドの寸法の計算
- コンポーネントを配置するセルの指定
- 行または列間へのウエイトと最小サイズの配分。
このメソッドは、
GridBagLayout
が内部的に使用するだけにしてください。- パラメータ:
parent
- レイアウト・コンテナsizeflag
-PREFERREDSIZE
またはMINSIZE
- 戻り値:
- 一連の子の
GridBagLayoutInfo
- 導入されたバージョン:
- 1.4
-
GetLayoutInfo
protected GridBagLayoutInfo GetLayoutInfo(Container parent, int sizeflag)
このメソッドは廃止されており、下位互換性のためにのみ提供されています。新しいコードは、かわりにgetLayoutInfo
を呼び出すようにしてください。 管理される子の現在のセットに対するGridBagLayoutInfo
のインスタンスに値を入力します。 このメソッドは、getLayoutInfo
と同じです; 詳細については、getLayoutInfo
の説明を参照してください。- パラメータ:
parent
- レイアウト・コンテナsizeflag
-PREFERREDSIZE
またはMINSIZE
- 戻り値:
- 一連の子の
GridBagLayoutInfo
-
adjustForGravity
protected void adjustForGravity(GridBagConstraints constraints, Rectangle r)
x、y、幅、高さフィールドを、制約幾何学的図形およびパッドに応じて正しい値に調整します。 このメソッドは、GridBagLayout
が内部的に使用するだけにしてください。- パラメータ:
constraints
- 適用される制約r
- 調整するRectangle
- 導入されたバージョン:
- 1.4
-
AdjustForGravity
protected void AdjustForGravity(GridBagConstraints constraints, Rectangle r)
x、y、幅、高さフィールドを、制約幾何学的図形およびパッドに応じて正しい値に調整します。このメソッドは廃止されており、下位互換性のためにのみ提供されています。新しいコードは、かわりに
adjustForGravity
を呼び出すようにしてください。 このメソッドは、adjustForGravity
と同じです。- パラメータ:
constraints
- 適用される制約r
- 調整するRectangle
-
getMinSize
protected Dimension getMinSize(Container parent, GridBagLayoutInfo info)
getLayoutInfo
の情報に基づいて、親の最小サイズを示します。 このメソッドは、GridBagLayout
が内部的に使用するだけにしてください。- パラメータ:
parent
- レイアウト・コンテナinfo
- この親のレイアウト情報- 戻り値:
- 最小サイズが格納されている
Dimension
オブジェクト - 導入されたバージョン:
- 1.4
-
GetMinSize
protected Dimension GetMinSize(Container parent, GridBagLayoutInfo info)
このメソッドは廃止されており、下位互換性のためにのみ提供されています。新しいコードは、かわりにgetMinSize
を呼び出すようにしてください。 このメソッドは、getMinSize
と同じです。- パラメータ:
parent
- レイアウト・コンテナinfo
- この親のレイアウト情報- 戻り値:
- 最小サイズが格納されている
Dimension
オブジェクト
-
arrangeGrid
protected void arrangeGrid(Container parent)
グリッドを配置します。 このメソッドは、GridBagLayout
が内部的に使用するだけにしてください。- パラメータ:
parent
- レイアウト・コンテナ- 導入されたバージョン:
- 1.4
-
ArrangeGrid
protected void ArrangeGrid(Container parent)
このメソッドは廃止されており、下位互換性のためにのみ提供されています。新しいコードは、かわりにarrangeGrid
を呼び出すようにしてください。 このメソッドは、arrangeGrid
と同じです。- パラメータ:
parent
- レイアウト・コンテナ
-
-