Container (Java Platform SE 7)

java.lang.Object
- java.awt.Component
- - java.awt.Container

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

ImageObserver, MenuContainer, Serializable

直系の既知のサブクラス:

BasicSplitPaneDivider, CellRendererPane, DefaultTreeCellEditor.EditorContainer, JComponent, Panel, ScrollPane, Window
```
public class Container
extends Component
```
ジェネリック Abstract Window Toolkit (AWT) コンテナオブジェクトは、ほかの AWT コンポーネントを含むことができるコンポーネントです。
コンテナに追加されるコンポーネントはリスト内で追跡されます。リストの順番は、コンテナ中の前面から後面へコンポーネントがスタックされる順番を表します。コンテナにコンポーネントを追加するときにインデックスが指定されないと、リストの最後尾に追加され、最後尾にスタックされます。
注:フォーカスサブシステムの詳細については、「The Java Tutorial」のセクション「How to Use the Focus Subsystem」、および「フォーカスの仕様」を参照してください。

導入されたバージョン:

JDK1.0

関連項目:
add(java.awt.Component, int), getComponent(int), LayoutManager, 直列化された形式

ネストされたクラスのサマリー

ネストされたクラス
修飾子と型	クラスと説明
`protected class`	`Container.AccessibleAWTContainer` アクセシビリティーのデフォルトサポートの提供に使用する Container の内部クラスです。

クラス java.awt.Component から継承されたネストされたクラス/インタフェース
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

フィールドのサマリー
- クラス java.awt.Component から継承されたフィールド
  BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
- インタフェース java.awt.image.ImageObserver から継承されたフィールド
  ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

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

コンストラクタ
コンストラクタと説明

Container()
新しいコンテナを構築します。

コンストラクタ
コンストラクタと説明
`Container()` 新しいコンテナを構築します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`Component`	`add(Component comp)` 指定されたコンポーネントをこのコンテナの最後に追加します。
`Component`	`add(Component comp, int index)` 指定されたコンポーネントを、このコンテナの指定された位置に追加します。
`void`	`add(Component comp, Object constraints)` 指定されたコンポーネントをこのコンテナの末尾に追加します。
`void`	`add(Component comp, Object constraints, int index)` 指定されたコンポーネントを、指定されたインデックスと指定された制約で、コンテナへ追加します。
`Component`	`add(String name, Component comp)` 指定されたコンポーネントをこのコンテナに追加します。
`void`	`addContainerListener(ContainerListener l)` このコンテナからのコンテナイベントを受け取れるように、指定されたコンテナリスナーを追加します。
`protected void`	`addImpl(Component comp, Object constraints, int index)` 指定されたコンポーネントを、指定されたインデックスで、コンテナへ追加します。
`void`	`addNotify()` ネイティブスクリーンリソースに接続することにより、この Container を表示可能にします。
`void`	`addPropertyChangeListener(PropertyChangeListener listener)` PropertyChangeListener をリスナーリストに追加します。
`void`	`addPropertyChangeListener(String propertyName, PropertyChangeListener listener)` 特定のプロパティーのリスナーリストに PropertyChangeListener を追加します。
`void`	`applyComponentOrientation(ComponentOrientation o)` このコンテナと、その中に含まれているすべてのコンポーネントの `ComponentOrientation` プロパティーを設定します。
`boolean`	`areFocusTraversalKeysSet(int id)` 指定されたフォーカストラバーサル操作に対するフォーカストラバーサルキーのセットが、このコンテナに明示的に定義されているかどうかを返します。
`int`	`countComponents()` 非推奨。 JDK Version 1.1 以降は、getComponentCount() に置き換えられています。
`void`	`deliverEvent(Event e)` 非推奨。 JDK Version 1.1 以降は、`dispatchEvent(AWTEvent e)` に置き換えられています
`void`	`doLayout()` このコンテナによってコンポーネントが配置されます。
`Component`	`findComponentAt(int x, int y)` 指定された位置を格納する可視の子コンポーネントを探します。
`Component`	`findComponentAt(Point p)` 指定された点を格納する可視の子コンポーネントを探します。
`float`	`getAlignmentX()` x 軸方向の配置を返します。
`float`	`getAlignmentY()` y 軸方向の配置を返します。
`Component`	`getComponent(int n)` コンテナ内の n 番目のコンポーネントを取得します。
`Component`	`getComponentAt(int x, int y)` x、y 座標を含むコンポーネントを探します。
`Component`	`getComponentAt(Point p)` 指定された点を含むコンポーネントを取得します。
`int`	`getComponentCount()` このパネル内のコンポーネントの数を取得します。
`Component[]`	`getComponents()` コンテナ内のすべてのコンポーネントを取得します。
`int`	`getComponentZOrder(Component comp)` コンテナ内のコンポーネントの Z 軸順インデックスを返します。
`ContainerListener[]`	`getContainerListeners()` このコンテナに登録されているすべてのコンテナリスナーの配列を返します。
`Set<AWTKeyStroke>`	`getFocusTraversalKeys(int id)` このコンテナの指定されたトラバーサル操作のフォーカストラバーサルキーのセットを返します。
`FocusTraversalPolicy`	`getFocusTraversalPolicy()` このコンテナの子のキーボードトラバーサルを管理するフォーカストラバーサルポリシーを返します。このコンテナがフォーカスサイクルルートでない場合は null を返します。
`Insets`	`getInsets()` コンテナの境界のサイズを示す、このコンテナのインセットを判定します。
`LayoutManager`	`getLayout()` このコンテナのレイアウトマネージャーを取得します。
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)` この `Component` に `FooListener` として現在登録されているすべてのオブジェクトの配列を返します。
`Dimension`	`getMaximumSize()` このコンテナの最大サイズを返します。
`Dimension`	`getMinimumSize()` このコンテナの最小サイズを返します。
`Point`	`getMousePosition(boolean allowChildren)` `null` がマウスポインタの下にある場合は、この `Container` の座標空間内のマウスポインタの位置を返します。それ以外の場合は `Container` を返します。
`Dimension`	`getPreferredSize()` このコンテナの推奨サイズを返します。
`Insets`	`insets()` 非推奨。 JDK Version 1.1 以降は、`getInsets()` に置き換えられています。
`void`	`invalidate()` コンテナを無効にします。
`boolean`	`isAncestorOf(Component c)` コンポーネントがこのコンテナのコンポーネント階層に含まれているかどうかを判定します。
`boolean`	`isFocusCycleRoot()` このコンテナがフォーカストラバーサルサイクルのルートであるかどうかを返します。
`boolean`	`isFocusCycleRoot(Container container)` 指定されたコンテナが、このコンテナのフォーカストラバーサルサイクルのフォーカスサイクルルートであるかどうかを返します。
`boolean`	`isFocusTraversalPolicyProvider()` このコンテナがフォーカストラバーサルポリシーを提供するかどうかを返します。
`boolean`	`isFocusTraversalPolicySet()` フォーカストラバーサルポリシーがこのコンテナに対して明示的に設定されているかどうかを返します。
`boolean`	`isValidateRoot()` このコンテナが有効なルートであるかどうかを示します。
`void`	`layout()` 非推奨。 JDK Version 1.1 以降は、`doLayout()` に置き換えられています。
`void`	`list(PrintStream out, int indent)` 指定された出力ストリームにこのコンテナの一覧を出力します。
`void`	`list(PrintWriter out, int indent)` 指定されたインデント位置から、指定されたプリントライターに一覧を出力します。
`Component`	`locate(int x, int y)` 非推奨。 JDK Version 1.1 以降は、`getComponentAt(int, int)` に置き換えられています。
`Dimension`	`minimumSize()` 非推奨。 JDK Version 1.1 以降は、`getMinimumSize()` に置き換えられています。
`void`	`paint(Graphics g)` コンテナをペイントします。
`void`	`paintComponents(Graphics g)` このコンテナ内の各コンポーネントをペイントします。
`protected String`	`paramString()` この `Container` の状態を表す文字列を返します。
`Dimension`	`preferredSize()` 非推奨。 JDK Version 1.1 以降は、`getPreferredSize()` に置き換えられています。
`void`	`print(Graphics g)` コンテナを出力します。
`void`	`printComponents(Graphics g)` このコンテナ内の各コンポーネントを出力します。
`protected void`	`processContainerEvent(ContainerEvent e)` このコンテナで発生するコンテナイベントを、登録されている ContainerListener オブジェクトにディスパッチすることで処理します。
`protected void`	`processEvent(AWTEvent e)` このコンテナのイベントを処理します。
`void`	`remove(Component comp)` このコンテナから、指定されたコンポーネントを削除します。
`void`	`remove(int index)` このコンテナから、`index` によって指定されたコンポーネントを削除します。
`void`	`removeAll()` このコンテナからすべてのコンポーネントを削除します。
`void`	`removeContainerListener(ContainerListener l)` このコンテナからのコンテナイベントを受け取らないように、指定されたコンテナリスナーを削除します。
`void`	`removeNotify()` ネイティブスクリーンリソースへの接続を削除することにより、この Container を表示不可にします。
`void`	`setComponentZOrder(Component comp, int index)` 指定されたコンポーネントを、コンテナの指定された Z 軸順のインデックスに移動します。
`void`	`setFocusCycleRoot(boolean focusCycleRoot)` このコンテナがフォーカストラバーサルサイクルのルートであるかどうかを設定します。
`void`	`setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)` このコンテナの指定されたトラバーサル操作に対するフォーカストラバーサルキーを設定します。
`void`	`setFocusTraversalPolicy(FocusTraversalPolicy policy)` このコンテナがフォーカスサイクルルートの場合、このコンテナの子のキーボードトラバーサルを管理するフォーカストラバーサルポリシーを設定します。
`void`	`setFocusTraversalPolicyProvider(boolean provider)` このコンテナを使用して、フォーカストラバーサルポリシーを提供するかどうかを設定します。
`void`	`setFont(Font f)` このコンテナのフォントを設定します。
`void`	`setLayout(LayoutManager mgr)` このコンテナのレイアウトマネージャーを設定します。
`void`	`transferFocusDownCycle()` フォーカスを 1 フォーカストラバーサルサイクルだけ下位に移動します。
`void`	`update(Graphics g)` コンテナを更新します。
`void`	`validate()` このコンテナおよびすべてのサブコンポーネントを検証します。
`protected void`	`validateTree()` コンテナツリーを再帰的に下位までたどり、必要であるとマークされたすべてのサブツリー、そして無効とマークされたすべてのサブツリーのレイアウトを再計算します。

クラス java.awt.Component から継承されたメソッド
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細
- Container
```
public Container()
```
  新しいコンテナを構築します。コンテナは直接拡張できますが、この場合は軽量であり、コンポーネントツリーの上位でネイティブな親コンテナに含まれなければいけません。(たとえば Frame)。

メソッドの詳細

getComponentCount
```
public int getComponentCount()
```
このパネル内のコンポーネントの数を取得します。
注:このメソッドは、AWT ツリーロックの下で呼び出すようにしてください。

戻り値:
このパネルのコンポーネント数
導入されたバージョン:

JDK1.1

関連項目:
getComponent(int), Component.getTreeLock()

countComponents
```
@Deprecated
public int countComponents()
```
非推奨。 JDK Version 1.1 以降は、getComponentCount() に置き換えられています。

getComponent
```
public Component getComponent(int n)
```
コンテナ内の n 番目のコンポーネントを取得します。
注:このメソッドは、AWT ツリーロックの下で呼び出すようにしてください。

パラメータ:
n - 取得するコンポーネントのインデックス

戻り値:
このコンテナ内の n 番目のコンポーネント

例外:

ArrayIndexOutOfBoundsException - n 番目の値がない場合
関連項目:
Component.getTreeLock()

getComponents
```
public Component[] getComponents()
```
コンテナ内のすべてのコンポーネントを取得します。
注:このメソッドは、AWT ツリーロックの下で呼び出すようにしてください。

戻り値:
このコンテナ内のすべてのコンポーネントの配列
関連項目:
Component.getTreeLock()

getInsets
```
public Insets getInsets()
```
コンテナの境界のサイズを示す、このコンテナのインセットを判定します。
たとえば、Frame オブジェクトは、フレームのタイトルバーの高さに対応する上のインセットを持ちます。

戻り値:
このコンテナのインセット
導入されたバージョン:

JDK1.1

関連項目:
Insets, LayoutManager

insets
```
@Deprecated
public Insets insets()
```
非推奨。 JDK Version 1.1 以降は、getInsets() に置き換えられています。

add
```
public Component add(Component comp)
```
指定されたコンポーネントをこのコンテナの最後に追加します。これは addImpl(java.awt.Component, java.lang.Object, int) の簡易メソッドです。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。コンテナがすでに表示されている場合は、追加されたコンポーネントを表示するために、あとで階層を検証する必要があります。

パラメータ:
comp - 追加されるコンポーネント

戻り値:
コンポーネント引数

例外:

NullPointerException - comp が null の場合
関連項目:
addImpl(java.awt.Component, java.lang.Object, int), invalidate(), validate(), JComponent.revalidate()

add
```
public Component add(String name,
            Component comp)
```
指定されたコンポーネントをこのコンテナに追加します。これは addImpl(java.awt.Component, java.lang.Object, int) の簡易メソッドです。
このメソッドは 1.1 から非推奨です。代わりに add(Component, Object) メソッドを使用してください。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。コンテナがすでに表示されている場合は、追加されたコンポーネントを表示するために、あとで階層を検証する必要があります。

例外:

NullPointerException - comp が null の場合
関連項目:
add(Component, Object), invalidate()

add
```
public Component add(Component comp,
            int index)
```
指定されたコンポーネントを、このコンテナの指定された位置に追加します。これは addImpl(java.awt.Component, java.lang.Object, int) の簡易メソッドです。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。コンテナがすでに表示されている場合は、追加されたコンポーネントを表示するために、あとで階層を検証する必要があります。

パラメータ:
comp - 追加されるコンポーネント
index - コンポーネントを挿入する位置。コンポーネントを末尾に挿入する場合は -1

戻り値:
コンポーネント comp

例外:

NullPointerException - comp が null の場合

IllegalArgumentException - index が無効である場合 (詳細は addImpl(java.awt.Component, java.lang.Object, int) を参照)
関連項目:
addImpl(java.awt.Component, java.lang.Object, int), remove(int), invalidate(), validate(), JComponent.revalidate()

setComponentZOrder
```
public void setComponentZOrder(Component comp,
                      int index)
```
指定されたコンポーネントを、コンテナの指定された Z 軸順のインデックスに移動します。Z 軸順によって、コンポーネントがペイントされる順番が決まります。Z 軸順が最高のコンポーネントが最初にペイントされ、Z 軸順が最低のコンポーネントが最後にペイントされます。コンポーネントがオーバーラップされる場合、Z 軸順の低いコンポーネントが Z 軸順の高いコンポーネントの上にペイントされます。
コンポーネントがほかのコンテナの子である場合、このコンテナに追加される前にそのコンテナから削除されます。このメソッドと java.awt.Container.add(Component, int) の違いは、前のコンテナから削除される際に、必要でない限り、また基本となるネィティブウィンドウシステムによって許可されているかぎり、このメソッドがコンポーネントに対して removeNotify を呼び出さないことです。このように、コンポーネントにキーボードフォーカスがある場合、そのコンポーネントが新しい位置に移動されてもフォーカスを維持します。
このプロパティーは軽量の Container 以外のコンポーネントのみに適用されます。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。
注: removeNotify を呼び出さずに、別のコンテナへの重量コンポーネントの Z 軸順の変更をサポートしていないプラットフォームもあります。プラットフォームでこれがサポートされているかどうかを判断する方法はないため、開発者は推測しないようにしてください。

パラメータ:
comp - 移動されるコンポーネント
index - コンポーネントを挿入するコンテナのリスト内での位置。getComponentCount() は末尾に挿入することを意味する

例外:

NullPointerException - comp が null の場合

IllegalArgumentException - comp がコンテナの親のいずれかである場合

IllegalArgumentException - コンテナ間の移動で、index が [0, getComponentCount()] の範囲にない場合、またはコンテナ内の移動で [0, getComponentCount()-1] の範囲にない場合

IllegalArgumentException - コンテナをそのコンテナ自体に追加しようとしている場合

IllegalArgumentException - Window をコンテナに追加しようとしている場合
導入されたバージョン:

1.5

関連項目:
getComponentZOrder(java.awt.Component), invalidate()

getComponentZOrder
```
public int getComponentZOrder(Component comp)
```
コンテナ内のコンポーネントの Z 軸順インデックスを返します。Z 軸順階層が高いコンポーネントほど、そのインデックスは低くなります。Z 軸順インデックスが最低のコンポーネントがほかの子コンポーネントの最後にペイントされます。

パラメータ:
comp - 照会されるコンポーネント

戻り値:
コンポーネントの Z 軸順インデックス。コンポーネントが null またはコンテナに属さない場合は -1 を返す
導入されたバージョン:

1.5

関連項目:
setComponentZOrder(java.awt.Component, int)

add
```
public void add(Component comp,
       Object constraints)
```
指定されたコンポーネントをこのコンテナの末尾に追加します。また、指定された制約オブジェクトを使用して、このコンテナのレイアウトにコンポーネントを追加することをレイアウトマネージャーに通知します。これは addImpl(java.awt.Component, java.lang.Object, int) の簡易メソッドです。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。コンテナがすでに表示されている場合は、追加されたコンポーネントを表示するために、あとで階層を検証する必要があります。

パラメータ:
comp - 追加されるコンポーネント
constraints - このコンポーネントのレイアウト制約を表現するオブジェクト

例外:

NullPointerException - comp が null の場合
導入されたバージョン:

JDK1.1

関連項目:
addImpl(java.awt.Component, java.lang.Object, int), invalidate(), validate(), JComponent.revalidate(), LayoutManager

add
```
public void add(Component comp,
       Object constraints,
       int index)
```
指定されたコンポーネントを、指定されたインデックスと指定された制約で、コンテナへ追加します。また、指定された制約オブジェクトを使用して、このコンテナのレイアウトにコンポーネントを追加することをレイアウトマネージャーに通知します。これは addImpl(java.awt.Component, java.lang.Object, int) の簡易メソッドです。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。コンテナがすでに表示されている場合は、追加されたコンポーネントを表示するために、あとで階層を検証する必要があります。

パラメータ:
comp - 追加されるコンポーネント
constraints - これのレイアウト制約を表現するオブジェクト
index - コンポーネントを挿入するコンテナのリスト内の位置。-1 は最後に挿入することを意味する

例外:

NullPointerException - comp が null の場合

IllegalArgumentException - index が無効である場合 (詳細は addImpl(java.awt.Component, java.lang.Object, int) を参照)
関連項目:
addImpl(java.awt.Component, java.lang.Object, int), invalidate(), validate(), JComponent.revalidate(), remove(int), LayoutManager

addImpl
```
protected void addImpl(Component comp,
           Object constraints,
           int index)
```
指定されたコンポーネントを、指定されたインデックスで、コンテナへ追加します。また、このメソッドは、addLayoutComponent メソッドを使用して、指定された制約オブジェクトを使ってこのコンテナのレイアウトにコンポーネントを追加することをレイアウトマネージャーに通知します。
制約は、使用されているレイアウトマネージャーで定義されます。たとえば BorderLayout クラスは、BorderLayout.NORTH、BorderLayout.SOUTH、BorderLayout.EAST、BorderLayout.WEST、および BorderLayout.CENTER の 5 つの制約を定義します。
GridBagLayout クラスには GridBagConstraints オブジェクトが必要です。正しい型の制約オブジェクトを渡さないと、IllegalArgumentException が発生します。
現在のレイアウトマネージャーが LayoutManager2 を実装する場合は、LayoutManager2.addLayoutComponent(Component,Object) が呼び出されます。現在のレイアウトマネージャーが LayoutManager2 を実装せず、制約が String の場合は、LayoutManager.addLayoutComponent(String,Component) が呼び出されます。
コンポーネントがこのコンテナの祖先ではなく、null でない親を持つ場合は、このコンテナに追加される前に現在の親から削除されます。
これは、プログラムがコンテナへのすべての追加要求を追跡する必要がある場合にオーバーライドするメソッドです。ほかのすべての追加メソッドはこれに従います。オーバーライドするメソッドは通常、メソッドのスーパークラスバージョンへの呼び出しを含めるようにしてください。

super.addImpl(comp, constraints, index)

このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。コンテナがすでに表示されている場合は、追加されたコンポーネントを表示するために、あとで階層を検証する必要があります。

パラメータ:
comp - 追加されるコンポーネント
constraints - このコンポーネントのレイアウト制約を表現するオブジェクト
index - コンポーネントを挿入するコンテナのリスト内での位置。-1 は最後に挿入することを意味する

例外:

IllegalArgumentException - index が無効な場合。comp がこのコンテナの子であれば、有効な範囲は [-1, getComponentCount()-1]。コンポーネントがこのコンテナの子でなければ、有効な範囲は [-1, getComponentCount()]

IllegalArgumentException - comp がこのコンテナの祖先の場合

IllegalArgumentException - ウィンドウをコンテナに追加しようとしている場合

NullPointerException - comp が null の場合
導入されたバージョン:

JDK1.1

関連項目:
add(Component), add(Component, int), add(Component, java.lang.Object), invalidate(), LayoutManager, LayoutManager2

remove
```
public void remove(int index)
```
このコンテナから、index によって指定されたコンポーネントを削除します。このメソッドはまた、removeLayoutComponent メソッドを使用してこのコンテナのレイアウトからコンポーネントを削除するために、レイアウトマネージャーにも通知します。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。コンテナがすでに表示されている場合は、変更を反映するために、あとで階層を検証する必要があります。

パラメータ:
index - 削除されるコンポーネントのインデックス

例外:

ArrayIndexOutOfBoundsException - index が [0, getComponentCount()-1] の範囲内にない場合
導入されたバージョン:

JDK1.1

関連項目:
add(java.awt.Component), invalidate(), validate(), getComponentCount()

remove
```
public void remove(Component comp)
```
このコンテナから、指定されたコンポーネントを削除します。このメソッドはまた、removeLayoutComponent メソッドを使用してこのコンテナのレイアウトからコンポーネントを削除するために、レイアウトマネージャーにも通知します。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。コンテナがすでに表示されている場合は、変更を反映するために、あとで階層を検証する必要があります。

パラメータ:
comp - 削除されるコンポーネント

例外:

NullPointerException - comp が null の場合
関連項目:
add(java.awt.Component), invalidate(), validate(), remove(int)

removeAll
```
public void removeAll()
```
このコンテナからすべてのコンポーネントを削除します。このメソッドはまた、removeLayoutComponent メソッドを使用してこのコンテナのレイアウトからコンポーネントを削除するために、レイアウトマネージャーにも通知します。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。コンテナがすでに表示されている場合は、変更を反映するために、あとで階層を検証する必要があります。

関連項目:
add(java.awt.Component), remove(int), invalidate()

getLayout
```
public LayoutManager getLayout()
```
このコンテナのレイアウトマネージャーを取得します。

関連項目:
doLayout(), setLayout(java.awt.LayoutManager)

setLayout
```
public void setLayout(LayoutManager mgr)
```
このコンテナのレイアウトマネージャーを設定します。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。

パラメータ:
mgr - 指定されたレイアウトマネージャー
関連項目:
doLayout(), getLayout(), invalidate()

doLayout
```
public void doLayout()
```
このコンテナによってコンポーネントが配置されます。ほとんどのプログラムは、このメソッドを直接呼び出すのではなく、validate メソッドを呼び出すようにしてください。

オーバーライド:

doLayout、クラス: Component

導入されたバージョン:

JDK1.1

関連項目:
LayoutManager.layoutContainer(java.awt.Container), setLayout(java.awt.LayoutManager), validate()

layout
```
@Deprecated
public void layout()
```
非推奨。 JDK Version 1.1 以降は、doLayout() に置き換えられています。

オーバーライド:

layout、クラス: Component

isValidateRoot
```
public boolean isValidateRoot()
```
このコンテナが有効なルートであるかどうかを示します。
レイアウトに関連する変更 (有効なルートの子孫の境界など) は、有効なルートの親のレイアウトには影響を与えません。この特殊性により、invalidate() メソッドは、有効なルートを検出した時点でコンポーネント階層の無効化を停止できます。ただし、下位互換性を保つために、java.awt.smartInvalidate システムプロパティーの値が true に設定されている場合にかぎり、この最適化された新しい動作が使用可能になります。
コンポーネント階層内に有効なルートがあり、最適化された新しい invalidate() 動作が使用可能な場合、あとで階層の有効性を復元するには、すでに無効化されているコンポーネントの有効なルートに対して validate() メソッドを呼び出す必要があります。それ以外の場合、コンポーネント階層の有効性を復元するには、トップレベルのコンテナ (Frame オブジェクトなど) に対して validate() メソッドを呼び出す必要があります。
Window クラスと Applet クラスは AWT の有効なルートです。Swing ではより多くの有効なルートが導入されます。

戻り値:
このコンテナが有効なルートであるかどうか
導入されたバージョン:

1.7

関連項目:
invalidate(), Component.invalidate(), JComponent.isValidateRoot(), JComponent.revalidate()

invalidate
```
public void invalidate()
```
コンテナを無効にします。
このコンテナにインストールされている LayoutManager が LayoutManager2 インタフェースのインスタンスである場合は、この Container を引数として LayoutManager2.invalidateLayout(Container) メソッドが呼び出されます。
その後、このメソッドはこのコンテナを無効とマークし、その祖先を無効化します。詳細は、Component.invalidate() メソッドを参照してください。

オーバーライド:

invalidate、クラス: Component

関連項目:
validate(), layout(), LayoutManager2

validate
```
public void validate()
```
このコンテナおよびすべてのサブコンポーネントを検証します。
コンテナの検証とは、そのサブコンポーネントを配置することを意味します。レイアウトに関連する変更 (コンポーネントの境界の設定、コンテナへのコンポーネントの追加など) により、コンテナは自動的に無効化されます。コンテナの祖先も無効化される場合があります (詳細は、Component.invalidate() を参照)。したがって、階層の有効性を復元するには、階層内で無効になっているもっとも上位のコンテナに対して validate() メソッドを呼び出すようにしてください。
コンテナの検証にはかなり時間がかかる場合があります。パフォーマンス上の理由から、開発者はレイアウトに関連する一連の操作が完了するまで、たとえば、コンテナにすべての子を追加し終わるまで、階層の検証を延期できます。
この Container が有効でない場合、このメソッドは validateTree メソッドを呼び出し、この Container を有効としてマークします。それ以外の場合は、何の処理も行いません。

オーバーライド:

validate、クラス: Component

関連項目:
add(java.awt.Component), invalidate(), isValidateRoot(), JComponent.revalidate(), validateTree()

validateTree
```
protected void validateTree()
```
コンテナツリーを再帰的に下位までたどり、必要であるとマークされたすべてのサブツリー、そして無効とマークされたすべてのサブツリーのレイアウトを再計算します。同期化は、この validate を呼び出すメソッドによって提供するようにしてください。

関連項目:
doLayout(), validate()

setFont
```
public void setFont(Font f)
```
このコンテナのフォントを設定します。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。

オーバーライド:

setFont、クラス: Component

パラメータ:
f - このコンテナのフォントとして設定するフォント
導入されたバージョン:

JDK1.0

関連項目:
Component.getFont(), invalidate()

getPreferredSize
```
public Dimension getPreferredSize()
```
このコンテナの推奨サイズを返します。推奨サイズが Component.setPreferredSize(Dimension) によって明示的に設定されていない場合で、この Container に non-null LayoutManager があるときは、LayoutManager.preferredLayoutSize(Container) を使用して推奨サイズが計算されます。
注:実装によっては、LayoutManager から返された値がキャッシュされることがあります。キャッシュする実装では、このメソッドが呼び出されるたびに LayoutManager の preferredLayoutSize を呼び出す必要はなく、Container が無効になったあとにだけ LayoutManager が照会されます。

オーバーライド:

getPreferredSize、クラス: Component

戻り値:
このコンテナの推奨サイズを表す Dimension のインスタンス
関連項目:
getMinimumSize(), getMaximumSize(), getLayout(), LayoutManager.preferredLayoutSize(Container), Component.getPreferredSize()

preferredSize
```
@Deprecated
public Dimension preferredSize()
```
非推奨。 JDK Version 1.1 以降は、getPreferredSize() に置き換えられています。

オーバーライド:

preferredSize、クラス: Component

getMinimumSize
```
public Dimension getMinimumSize()
```
このコンテナの最小サイズを返します。最小サイズが Component.setMinimumSize(Dimension) によって明示的に設定されていない場合で、この Container に non-null LayoutManager があるときは、LayoutManager.minimumLayoutSize(Container) を使用して最小サイズが計算されます。
注:実装によっては、LayoutManager から返された値がキャッシュされることがあります。キャッシュする実装では、このメソッドが呼び出されるたびに LayoutManager の minimumLayoutSize を呼び出す必要はなく、Container が無効になったあとにだけ LayoutManager が照会されます。

オーバーライド:

getMinimumSize、クラス: Component

戻り値:
このコンテナの最小サイズを表す Dimension のインスタンス
導入されたバージョン:

JDK1.1

関連項目:
getPreferredSize(), getMaximumSize(), getLayout(), LayoutManager.minimumLayoutSize(Container), Component.getMinimumSize()

minimumSize
```
@Deprecated
public Dimension minimumSize()
```
非推奨。 JDK Version 1.1 以降は、getMinimumSize() に置き換えられています。

オーバーライド:

minimumSize、クラス: Component

getMaximumSize
```
public Dimension getMaximumSize()
```
このコンテナの最大サイズを返します。最大サイズが Component.setMaximumSize(Dimension) によって明示的に設定されていない場合で、この Container にインストールされている LayoutManager がLayoutManager2 のインスタンスであるときは、LayoutManager2.maximumLayoutSize(Container) を使用して最大サイズが計算されます。
注:実装によっては、LayoutManager2 から返された値がキャッシュされることがあります。キャッシュする実装では、このメソッドが呼び出されるたびに LayoutManager2 の maximumLayoutSize を呼び出す必要はなく、Container が無効になったあとにだけ LayoutManager2 が照会されます。

オーバーライド:

getMaximumSize、クラス: Component

戻り値:
このコンテナの最大サイズを表す Dimension のインスタンス
関連項目:
getPreferredSize(), getMinimumSize(), getLayout(), LayoutManager2.maximumLayoutSize(Container), Component.getMaximumSize()

getAlignmentX
```
public float getAlignmentX()
```
x 軸方向の配置を返します。これは、そのコンポーネントがほかのコンポーネントに対してどのように配置されるべきかを指定したものです。この値は 0 から 1 の間の数値で、0 は原点に沿った配置を表し、1 は原点からもっとも遠いところに、0.5 は中央に配置されます。

オーバーライド:

getAlignmentX、クラス: Component

getAlignmentY
```
public float getAlignmentY()
```
y 軸方向の配置を返します。これは、そのコンポーネントがほかのコンポーネントに対してどのように配置されるべきかを指定したものです。この値は 0 から 1 の間の数値で、0 は原点に沿った配置を表し、1 は原点からもっとも遠いところに、0.5 は中央に配置されます。

オーバーライド:

getAlignmentY、クラス: Component

paint
```
public void paint(Graphics g)
```
コンテナをペイントします。このコンテナの子コンポーネントであるすべての軽量コンポーネントへペイントを転送します。このメソッドが再実装される場合、軽量コンポーネントが正しく描画されるように super.paint(g) を呼び出すようにしてください。子コンポーネントが g の現在のクリッピング設定によって全体的にクリップされる場合、paint() はその子には転送されません。

オーバーライド:

paint、クラス: Component

パラメータ:
g - 指定された Graphics ウィンドウ
関連項目:
Component.update(Graphics)

update
```
public void update(Graphics g)
```
コンテナを更新します。このメソッドは、このコンテナの子である軽量コンポーネントに更新を転送します。このメソッドが再実装される場合、軽量コンポーネントが適切に描画されるように super.update(g) を呼び出すようにしてください。子コンポーネントが g の現在のクリッピング設定によって全体的にクリップされる場合、update() はその子には転送されません。

オーバーライド:

update、クラス: Component

パラメータ:
g - 指定された Graphics ウィンドウ
関連項目:
Component.update(Graphics)

print
```
public void print(Graphics g)
```
コンテナを出力します。このメソッドは、このコンテナの子である軽量コンポーネントに出力を転送します。このメソッドが再実装された場合、super.print(g) を呼び出して軽量コンポーネントを適切に描画する必要があります。このメソッドが再実装される場合、軽量コンポーネントが適切に描画されるように super.print(g) を呼び出すようにしてください。子コンポーネントが g の現在のクリッピング設定によって全体的にクリップされる場合、print() はその子には転送されません。

オーバーライド:

print、クラス: Component

パラメータ:
g - 指定された Graphics ウィンドウ
関連項目:
Component.update(Graphics)

paintComponents
```
public void paintComponents(Graphics g)
```
このコンテナ内の各コンポーネントをペイントします。

パラメータ:
g - グラフィックスコンテキスト。
関連項目:
Component.paint(java.awt.Graphics), Component.paintAll(java.awt.Graphics)

printComponents
```
public void printComponents(Graphics g)
```
このコンテナ内の各コンポーネントを出力します。

パラメータ:
g - グラフィックスコンテキスト。
関連項目:
Component.print(java.awt.Graphics), Component.printAll(java.awt.Graphics)

addContainerListener
```
public void addContainerListener(ContainerListener l)
```
このコンテナからのコンテナイベントを受け取れるように、指定されたコンテナリスナーを追加します。l が null の場合、例外はスローされず、処理も実行されません。
AWT スレッドモデルの詳細は、「AWT のスレッドの問題」を参照してください。

パラメータ:
l - コンテナリスナー
関連項目:
removeContainerListener(java.awt.event.ContainerListener), getContainerListeners()

removeContainerListener
```
public void removeContainerListener(ContainerListener l)
```
このコンテナからのコンテナイベントを受け取らないように、指定されたコンテナリスナーを削除します。l が null の場合、例外はスローされず、処理も実行されません。
AWT スレッドモデルの詳細は、「AWT のスレッドの問題」を参照してください。

パラメータ:
l - コンテナリスナー
関連項目:
addContainerListener(java.awt.event.ContainerListener), getContainerListeners()

getContainerListeners
```
public ContainerListener[] getContainerListeners()
```
このコンテナに登録されているすべてのコンテナリスナーの配列を返します。

戻り値:
このコンテナのすべての ContainerListener。コンテナリスナーが現在登録されていない場合は、空の配列
導入されたバージョン:

1.4

関連項目:
addContainerListener(java.awt.event.ContainerListener), removeContainerListener(java.awt.event.ContainerListener)

getListeners
```
public <T extends EventListener> T[] getListeners(Class<T> listenerType)
```
この Container に FooListener として現在登録されているすべてのオブジェクトの配列を返します。FooListener は、addFooListener メソッドを使用して登録されます。
FooListener.class などのクラスリテラルを使用して listenerType 引数を指定できます。たとえば、次のコードを使用して、Container c のコンテナリスナーを照会できます。
```
ContainerListener[] cls = (ContainerListener[])(c.getListeners(ContainerListener.class));
```
このようなリスナーがない場合は空の配列を返します。
オーバーライド:

getListeners、クラス: Component

パラメータ:
listenerType - 要求されるリスナーの型。java.util.EventListener の子孫のインタフェースを指定してください

戻り値:
このコンテナ上で FooListener として登録されたすべてのオブジェクトの配列、またはこのようなリスナーが追加されていない場合は空の配列

例外:

ClassCastException - listenerType で、java.util.EventListener を実装するクラスまたはインタフェースが指定されなかった場合

NullPointerException - listenerType が null の場合
導入されたバージョン:

1.3

関連項目:
getContainerListeners()

processEvent
```
protected void processEvent(AWTEvent e)
```
このコンテナのイベントを処理します。イベントが ContainerEvent である場合、processContainerEvent メソッドを呼び出します。そうでない場合は、スーパークラスの processEvent を呼び出します。
イベントパラメータが null である場合は、動作が未指定のため、例外が発生する可能性があります。

オーバーライド:

processEvent、クラス: Component

パラメータ:
e - イベント
関連項目:
Component.processComponentEvent(java.awt.event.ComponentEvent), Component.processFocusEvent(java.awt.event.FocusEvent), Component.processKeyEvent(java.awt.event.KeyEvent), Component.processMouseEvent(java.awt.event.MouseEvent), Component.processMouseMotionEvent(java.awt.event.MouseEvent), Component.processInputMethodEvent(java.awt.event.InputMethodEvent), Component.processHierarchyEvent(java.awt.event.HierarchyEvent), Component.processMouseWheelEvent(java.awt.event.MouseWheelEvent)

processContainerEvent
```
protected void processContainerEvent(ContainerEvent e)
```
このコンテナで発生するコンテナイベントを、登録されている ContainerListener オブジェクトにディスパッチすることで処理します。注:このメソッドは、このコンポーネントのコンテナイベントが有効になった時点で呼び出されます。これは、次のいずれかが発生したときに発生します。
- ContainerListener オブジェクトが addContainerListener を使用して登録されている
- enableEvents によってコンテナイベントが使用可能になっている
イベントパラメータが null である場合は、動作が未指定のため、例外が発生する可能性があります。
パラメータ:
e - コンテナイベント
関連項目:
Component.enableEvents(long)

deliverEvent
```
@Deprecated
public void deliverEvent(Event e)
```
非推奨。 JDK Version 1.1 以降は、dispatchEvent(AWTEvent e) に置き換えられています。

オーバーライド:

deliverEvent、クラス: Component

getComponentAt
```
public Component getComponentAt(int x,
                       int y)
```
x、y 座標を含むコンポーネントを探します。コンポーネントがオーバーラップしている場合、最上部の子コンポーネントが返されます。これは、指定された点を含んでいると Component.contains() が判断する、インデックス 0 にもっとも近いコンポーネントを見つけることで決定されます。ネイティブピアを持つコンポーネントは、ネイティブピアを持たないコンポーネント (軽量コンポーネント) より優先されます。

オーバーライド:

getComponentAt、クラス: Component

パラメータ:
x - x 座標
y - y 座標

戻り値:
コンポーネントがその位置を含まない場合は null。要求された点に子コンポーネントがなく、その点がコンテナの境界内にある場合は、コンテナ自身が返される。そうでない場合は、最上部の子コンポーネントが返される
導入されたバージョン:

JDK1.1

関連項目:
Component.contains(int, int)

locate
```
@Deprecated
public Component locate(int x,
                          int y)
```
非推奨。 JDK Version 1.1 以降は、getComponentAt(int, int) に置き換えられています。

オーバーライド:

locate、クラス: Component

getComponentAt
```
public Component getComponentAt(Point p)
```
指定された点を含むコンポーネントを取得します。

オーバーライド:

getComponentAt、クラス: Component

パラメータ:
p - 点。

戻り値:
点を含むコンポーネントを返す。コンポーネントがその点を含まない場合は null を返す
導入されたバージョン:

JDK1.1

関連項目:
Component.contains(int, int)

getMousePosition
```
public Point getMousePosition(boolean allowChildren)
                       throws HeadlessException
```
null がマウスポインタの下にある場合は、この Container の座標空間内のマウスポインタの位置を返します。それ以外の場合は Container を返します。このメソッドは、Container の子が考慮されることを除けば、Component.getMousePosition() と似ています。allowChildren が false の場合は、マウスポインタが Container の直接の上にあり、子によって隠されている部分の上にない場合にのみ、null 以外の値を返します。allowChildren が true の場合は、マウスポインタが Container またはそのいずれかの子孫の上にある場合に、null 以外の値を返します。

パラメータ:
allowChildren - 子を考慮するべき場合は true

戻り値:
この Component を基準にしたマウス座標、または null

例外:

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合
導入されたバージョン:

1.5

関連項目:
Component.getMousePosition()

findComponentAt
```
public Component findComponentAt(int x,
                        int y)
```
指定された位置を格納する可視の子コンポーネントを探します。コンポーネントがオーバーラップしている場合、最上部の子コンポーネントが返されます。包含している子コンポーネントが Container の場合、このメソッドは、もっとも深くネストされた子コンポーネントを検索し続けます。可視でないコンポーネントは検索時に無視されます。
findComponentAt メソッドは、Container の直接の子だけを検索する getComponentAt とは異なります。包含しているコンポーネントが Container の場合、findComponentAt はその子を検索してネストされたコンポーネントを見つけます。

パラメータ:
x - x 座標
y - y 座標

戻り値:
コンポーネントがその位置を含まない場合は null。要求された点に子コンポーネントがなく、その点がコンテナの境界内にある場合は、コンテナ自身が返される
導入されたバージョン:

1.2

関連項目:
Component.contains(int, int), getComponentAt(int, int)

findComponentAt
```
public Component findComponentAt(Point p)
```
指定された点を格納する可視の子コンポーネントを探します。コンポーネントがオーバーラップしている場合、最上部の子コンポーネントが返されます。包含している子コンポーネントが Container の場合、このメソッドは、もっとも深くネストされた子コンポーネントを検索し続けます。可視でないコンポーネントは検索時に無視されます。
findComponentAt メソッドは、Container の直接の子だけを検索する getComponentAt とは異なります。包含しているコンポーネントが Container の場合、findComponentAt はその子を検索してネストされたコンポーネントを見つけます。

パラメータ:
p - 点。

戻り値:
コンポーネントがその位置を含まない場合は null。要求された点に子コンポーネントがなく、その点がコンテナの境界内にある場合は、コンテナ自身が返される

例外:

NullPointerException - p が null の場合
導入されたバージョン:

1.2

関連項目:
Component.contains(int, int), getComponentAt(int, int)

addNotify
```
public void addNotify()
```
ネイティブスクリーンリソースに接続することにより、この Container を表示可能にします。コンテナを表示可能にすると、そのコンテナのすべての子も表示可能になります。このメソッドは、ツールキットによって内部的に呼び出されます。プログラムによって直接呼び出すべきではありません。

オーバーライド:

addNotify、クラス: Component

関連項目:
Component.isDisplayable(), removeNotify()

removeNotify
```
public void removeNotify()
```
ネイティブスクリーンリソースへの接続を削除することにより、この Container を表示不可にします。コンテナを表示不可にすると、そのコンテナのすべての子も表示不可になります。このメソッドは、ツールキットによって内部的に呼び出されます。プログラムによって直接呼び出すべきではありません。

オーバーライド:

removeNotify、クラス: Component

関連項目:
Component.isDisplayable(), addNotify()

isAncestorOf
```
public boolean isAncestorOf(Component c)
```
コンポーネントがこのコンテナのコンポーネント階層に含まれているかどうかを判定します。

パラメータ:
c - コンポーネント

戻り値:
祖先の場合は true、そうでない場合は false
導入されたバージョン:

JDK1.1

paramString
```
protected String paramString()
```
この Container の状態を表す文字列を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる場合があります。返された文字列は空である可能性があリますが、null にはなりません。

オーバーライド:

paramString、クラス: Component

戻り値:
このコンテナのパラメータ文字列

list
```
public void list(PrintStream out,
        int indent)
```
指定された出力ストリームにこのコンテナの一覧を出力します。一覧は、指定されたインデント位置から開始されます。
コンテナの直接の子は、indent+1 のインデントで出力されます。これらの子の子は indent+2 で出力され、以降も同様です。

オーバーライド:

list、クラス: Component

パラメータ:
out - 出力ストリーム
indent - インデントするスペースの数

例外:

NullPointerException - out が null の場合
導入されたバージョン:

JDK1.0

関連項目:
Component.list(java.io.PrintStream, int)

list
```
public void list(PrintWriter out,
        int indent)
```
指定されたインデント位置から、指定されたプリントライターに一覧を出力します。
コンテナの直接の子は、indent+1 のインデントで出力されます。これらの子の子は indent+2 で出力され、以降も同様です。

オーバーライド:

list、クラス: Component

パラメータ:
out - プリントライター
indent - インデントするスペースの数

例外:

NullPointerException - out が null の場合
導入されたバージョン:

JDK1.1

関連項目:
Component.list(java.io.PrintWriter, int)

setFocusTraversalKeys

public void setFocusTraversalKeys(int id,
                         Set<? extends AWTKeyStroke> keystrokes)

このコンテナの指定されたトラバーサル操作に対するフォーカストラバーサルキーを設定します。

コンテナのフォーカストラバーサルキーのデフォルト値は実装によって異なります。Sun は特定のネイティブなプラットフォームに対するすべての実装で同じデフォルト値を使用することをお勧めします。Windows および Unix に対する推奨は次にリストされています。これらの推奨は Sun AWT の実装で使用されます。

識別子	意味	デフォルト
KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS	通常の順方向キーボードトラバーサル	TAB (KEY_PRESSED)、CTRL-TAB (KEY_PRESSED)
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS	通常のリバースキーボードトラバーサル	SHIFT-TAB (KEY_PRESSED)、CTRL-SHIFT-TAB (KEY_PRESSED)
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS	1 つ上のフォーカストラバーサルサイクルに移動	なし
KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS		1 つ下のフォーカストラバーサルサイクルに移動	なし

トラバーサルキーを無効化するためには、空のセットを使用します。Collections.EMPTY_SET の使用をお勧めします。

AWTKeyStroke API を使用すると、クライアントコードで KEY_PRESSED と KEY_RELEASED の 2 つの KeyEvent を指定できるようになり、フォーカストラバーサルを操作できるようになります。ただし、指定される KeyEvent に関係なく、関連付けられる KEY_TYPED イベントを含む、フォーカストラバーサルキーに関連するすべての KeyEvent は消費され、ほかのコンテナへのディスパッチは行われません。KEY_TYPED イベントのフォーカストラバーサル操作へのマッピング、1 つのイベントの複数のデフォルトフォーカストラバーサル操作へのマッピングは実行時エラーになります。

セットに値 null が指定されている場合、このコンテナはセットを親から継承します。このコンテナのすべての祖先のセットに値 null が指定されている場合、現在の KeyboardFocusManager のデフォルトセットが使用されます。

オーバーライド:: setFocusTraversalKeys、クラス: Component
パラメータ:: id - KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS、KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS のいずれか; keystrokes - 指定された操作に対する AWTKeyStroke のセット
例外:: IllegalArgumentException - id が KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS、KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS のどれでもない場合、キーストロークが null の場合、キーストロークのオブジェクトのどれかが AWTKeyStroke でない場合、キーストロークのどれかが KEY_TYPED イベントを表す場合、またはキーストロークのどかがこのコンテナの別のフォーカストラバーサル操作にマップされている場合
導入されたバージョン:: 1.4
関連項目:: getFocusTraversalKeys(int), KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS

getFocusTraversalKeys
```
public Set<AWTKeyStroke> getFocusTraversalKeys(int id)
```
このコンテナの指定されたトラバーサル操作のフォーカストラバーサルキーのセットを返します。(各キーの完全な説明については、setFocusTraversalKeys を参照してください。)
トラバーサルキーのセットがこのコンテナに対して明示的に定義されていない場合、このコンテナの親のセットが返されます。このコンテナのすべての祖先のセットが定義されていない場合、現在の KeyboardFocusManager のデフォルトセットが返されます。

オーバーライド:

getFocusTraversalKeys、クラス: Component

パラメータ:
id - KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS、KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS のいずれか

戻り値:
指定された操作に対する AWTKeyStrokes のセット。このセットは変更できない。また空白の可能性もある。null が返されることはない

例外:

IllegalArgumentException - id が KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS、KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS のいずれでもない場合
導入されたバージョン:

1.4

関連項目:
setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>), KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS

areFocusTraversalKeysSet
```
public boolean areFocusTraversalKeysSet(int id)
```
指定されたフォーカストラバーサル操作に対するフォーカストラバーサルキーのセットが、このコンテナに明示的に定義されているかどうかを返します。false が返される場合、このコンテナはセットを祖先から、または現在の KeyboardFocusManager から継承します。

オーバーライド:

areFocusTraversalKeysSet、クラス: Component

パラメータ:
id - KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS、KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS のいずれか

戻り値:
特定のフォーカストラバーサル操作に対するフォーカストラバーサルキーのセットがこのコンポーネントに対して明示的に定義されている場合は true、それ以外の場合は false

例外:

IllegalArgumentException - id が KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS、KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS のいずれでもない場合
導入されたバージョン:

1.4

isFocusCycleRoot
```
public boolean isFocusCycleRoot(Container container)
```
指定されたコンテナが、このコンテナのフォーカストラバーサルサイクルのフォーカスサイクルルートであるかどうかを返します。フォーカストラバーサルサイクルは、それぞれフォーカスサイクルルートを 1 つ持ち、フォーカスサイクルルート以外の各コンテナは、1 つのフォーカストラバーサルサイクルだけに所属します。フォーカスサイクルルートになっているコンテナは、それ自体がルートになっているフォーカスサイクルと、その 1 つ祖先のフォーカスサイクルルートが構成するフォーカスサイクルの両方に属します。このメソッドはどちらのコンテナに対しても、この場合 true を返します。

オーバーライド:

isFocusCycleRoot、クラス: Component

パラメータ:
container - テストされる Container

戻り値:
指定されたコンテナがこのコンテナのフォーカスサイクルルートの場合は true、そうでない場合は false
導入されたバージョン:

1.4

関連項目:
isFocusCycleRoot()

setFocusTraversalPolicy
```
public void setFocusTraversalPolicy(FocusTraversalPolicy policy)
```
このコンテナがフォーカスサイクルルートの場合、このコンテナの子のキーボードトラバーサルを管理するフォーカストラバーサルポリシーを設定します。引数が null の場合は、このコンテナは祖先のフォーカスサイクルルートからポリシーを継承します。null でない場合は、このポリシーは独自のキーボードトラバーサルポリシーを持たない、フォーカスサイクルルートのすべての子によって継承されます。この継承は、これらの子の下位まで再帰的に行われます。
このコンテナがフォーカスサイクルルートでない場合、ポリシーは記録されますが、このコンテナがフォーカスサイクルルートになるまでは、このコンテナが使用することも、ほかのコンテナによって継承されることもありません。

パラメータ:
policy - このコンテナの新しいフォーカストラバーサルポリシー
導入されたバージョン:

1.4

関連項目:
getFocusTraversalPolicy(), setFocusCycleRoot(boolean), isFocusCycleRoot(java.awt.Container)

getFocusTraversalPolicy
```
public FocusTraversalPolicy getFocusTraversalPolicy()
```
このコンテナの子のキーボードトラバーサルを管理するフォーカストラバーサルポリシーを返します。このコンテナがフォーカスサイクルルートでない場合は null を返します。このコンテナにトラバーサルポリシーが明示的に設定されていない場合は、このコンテナの祖先のフォーカスサイクルルートのポリシーが返されます。

戻り値:
このコンテナのフォーカストラバーサルポリシー。このコンテナがフォーカスサイクルルートでない場合は null
導入されたバージョン:

1.4

関連項目:
setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), setFocusCycleRoot(boolean), isFocusCycleRoot(java.awt.Container)

isFocusTraversalPolicySet
```
public boolean isFocusTraversalPolicySet()
```
フォーカストラバーサルポリシーがこのコンテナに対して明示的に設定されているかどうかを返します。false を返す場合、このコンテナは祖先のコンテナからトラバーサルポリシーを継承します。

戻り値:
このコンテナに対してフォーカストラバーサルポリシーが明示的に設定されている場合は true、そうでない場合は false
導入されたバージョン:

1.4

setFocusCycleRoot
```
public void setFocusCycleRoot(boolean focusCycleRoot)
```
このコンテナがフォーカストラバーサルサイクルのルートであるかどうかを設定します。フォーカスが一度トラバーサルサイクルに設定されると、サイクルを上位または下位に切り替えるキーを押さなければ、通常はフォーカストラバーサルを離れることはできません。通常のトラバーサルは、このコンテナとこのコンテナのすべての子孫 (下層のフォーカスサイクルルートの子孫でないもの) に制限されています。ただし FocusTraversalPolicy はこの制限を緩めることができます。たとえば ContainerOrderFocusTraversalPolicy は暗黙のダウンサイクルトラバーサルをサポートします。
コンテナの子のトラバーサル順を指定する別の方法は、このコンテナを「フォーカストラバーサルポリシープロバイダ」にすることです。

パラメータ:
focusCycleRoot - このコンテナがフォーカストラバーサルサイクルのルートであるかどうかを示す
導入されたバージョン:

1.4

関連項目:
isFocusCycleRoot(), setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), getFocusTraversalPolicy(), ContainerOrderFocusTraversalPolicy, setFocusTraversalPolicyProvider(boolean)

isFocusCycleRoot
```
public boolean isFocusCycleRoot()
```
このコンテナがフォーカストラバーサルサイクルのルートであるかどうかを返します。フォーカスが一度トラバーサルサイクルに設定されると、サイクルを上位または下位に切り替えるキーを押さなければ、通常はフォーカストラバーサルを離れることはできません。通常のトラバーサルは、このコンテナとこのコンテナのすべての子孫 (下層のフォーカスサイクルルートの子孫でないもの) に制限されています。ただし FocusTraversalPolicy はこの制限を緩めることができます。たとえば ContainerOrderFocusTraversalPolicy は暗黙のダウンサイクルトラバーサルをサポートします。

戻り値:
このコンテナがフォーカストラバーサルサイクルのルートであるかどうか
導入されたバージョン:

1.4

関連項目:
setFocusCycleRoot(boolean), setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), getFocusTraversalPolicy(), ContainerOrderFocusTraversalPolicy

setFocusTraversalPolicyProvider
```
public final void setFocusTraversalPolicyProvider(boolean provider)
```
このコンテナを使用して、フォーカストラバーサルポリシーを提供するかどうかを設定します。このプロパティーを true に設定したコンテナを使用して、もっとも近い上位フォーカスサイクルルートの代わりに、フォーカストラバーサルポリシーを取得します。

パラメータ:
provider - このコンテナを使用してフォーカストラバーサルポリシーを提供するかどうかを示す
導入されたバージョン:

1.5

関連項目:
setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), getFocusTraversalPolicy(), isFocusTraversalPolicyProvider()

isFocusTraversalPolicyProvider
```
public final boolean isFocusTraversalPolicyProvider()
```
このコンテナがフォーカストラバーサルポリシーを提供するかどうかを返します。このプロパティーが true に設定されている場合、キーボードフォーカスマネージャーがコンテナ階層からフォーカストラバーサルポリシーを検索する際に、このプロパティーが true のほかのすべてのコンテナまたはフォーカスサイクルルートの前にこのコンテナを検出したときは、そのフォーカストラバーサルポリシーがフォーカスサイクルルートのポリシーの代わりに使用されます。

戻り値:
このコンテナがフォーカストラバーサルポリシーを提供する場合は true、そうでない場合は false
導入されたバージョン:

1.5

関連項目:
setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), getFocusTraversalPolicy(), setFocusCycleRoot(boolean), setFocusTraversalPolicyProvider(boolean)

transferFocusDownCycle
```
public void transferFocusDownCycle()
```
フォーカスを 1 フォーカストラバーサルサイクルだけ下位に移動します。このコンテナがフォーカスサイクルルートの場合、フォーカス所有者はコンテナのデフォルトフォーカスコンポーネントになり、現在のフォーカスサイクルルートがこのコンテナに設定されます。コンテナがフォーカスサイクルルートではない場合、フォーカストラバーサル操作は行われません。

導入されたバージョン:

1.4

関連項目:
Component.requestFocus(), isFocusCycleRoot(java.awt.Container), setFocusCycleRoot(boolean)

applyComponentOrientation
```
public void applyComponentOrientation(ComponentOrientation o)
```
このコンテナと、その中に含まれているすべてのコンポーネントの ComponentOrientation プロパティーを設定します。
このメソッドではレイアウトに関連する情報が変更されるため、コンポーネント階層が無効になります。

オーバーライド:

applyComponentOrientation、クラス: Component

パラメータ:
o - このコンテナとそれに含まれるコンポーネントの、新しいコンポーネント方向

例外:

NullPointerException - orientation が null の場合。
導入されたバージョン:

1.4

関連項目:
Component.setComponentOrientation(java.awt.ComponentOrientation), Component.getComponentOrientation(), invalidate()

addPropertyChangeListener
```
public void addPropertyChangeListener(PropertyChangeListener listener)
```
PropertyChangeListener をリスナーリストに追加します。このリスナーは、次のような、このクラスのすべてのバウンドプロパティーに登録されます。
- このコンテナのフォント ("font")
- このコンテナのバックグラウンドカラー ("background")
- このコンテナのフォアグラウンドカラー ("foreground")
- このコンテナのフォーカス可能性 ("focusable")
- このコンテナのフォーカストラバーサルキーの (有効かどうかの) 状態 ("focusTraversalKeysEnabled")
- このコンテナの FORWARD_TRAVERSAL_KEYS のセット ("forwardFocusTraversalKeys")
- このコンテナの BACKWARD_TRAVERSAL_KEYS のセット ("backwardFocusTraversalKeys")
- このコンテナの UP_CYCLE_TRAVERSAL_KEYS のセット ("upCycleFocusTraversalKeys")
- このコンテナの DOWN_CYCLE_TRAVERSAL_KEYS のセット ("downCycleFocusTraversalKeys")
- このコンテナのフォーカストラバーサルポリシー ("focusTraversalPolicy")
- このコンテナのフォーカスサイクルルートの状態 ("focusCycleRoot")
このコンテナがバウンドプロパティーを継承する場合、継承されるプロパティーの変更に反応してイベントがトリガーされることはありません。
listener が null の場合、例外はスローされず、何も処理は行われません。
オーバーライド:

addPropertyChangeListener、クラス: Component

パラメータ:
listener - 追加される PropertyChangeListener
関連項目:
Component.removePropertyChangeListener(java.beans.PropertyChangeListener), addPropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)

addPropertyChangeListener
```
public void addPropertyChangeListener(String propertyName,
                             PropertyChangeListener listener)
```
特定のプロパティーのリスナーリストに PropertyChangeListener を追加します。ユーザー定義のプロパティー、または次のデフォルトのいずれかを指定できます。
- このコンテナのフォント ("font")
- このコンテナのバックグラウンドカラー ("background")
- このコンテナのフォアグラウンドカラー ("foreground")
- このコンテナのフォーカス可能性 ("focusable")
- このコンテナのフォーカストラバーサルキーの (有効かどうかの) 状態 ("focusTraversalKeysEnabled")
- このコンテナの FORWARD_TRAVERSAL_KEYS のセット ("forwardFocusTraversalKeys")
- このコンテナの BACKWARD_TRAVERSAL_KEYS のセット ("backwardFocusTraversalKeys")
- このコンテナの UP_CYCLE_TRAVERSAL_KEYS のセット ("upCycleFocusTraversalKeys")
- このコンテナの DOWN_CYCLE_TRAVERSAL_KEYS のセット ("downCycleFocusTraversalKeys")
- このコンテナのフォーカストラバーサルポリシー ("focusTraversalPolicy")
- このコンテナのフォーカスサイクルルートの状態 ("focusCycleRoot")
- このコンテナのフォーカストラバーサルポリシープロバイダの状態 ("focusTraversalPolicyProvider")
- このコンテナのフォーカストラバーサルポリシープロバイダの状態 ("focusTraversalPolicyProvider")
このコンテナがバウンドプロパティーを継承する場合、継承されるプロパティーの変更に反応してイベントがトリガーされることはありません。
listener が null の場合、例外はスローされず、何も処理は行われません。
オーバーライド:

addPropertyChangeListener、クラス: Component

パラメータ:
propertyName - 上記のプロパティー名のいずれか
listener - 追加される PropertyChangeListener
関連項目:
addPropertyChangeListener(java.beans.PropertyChangeListener), Component.removePropertyChangeListener(java.beans.PropertyChangeListener)

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス Container

ネストされたクラスのサマリー

クラス java.awt.Component から継承されたネストされたクラス/インタフェース

フィールドのサマリー

クラス java.awt.Component から継承されたフィールド

インタフェース java.awt.image.ImageObserver から継承されたフィールド

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

メソッドのサマリー

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

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

コンストラクタの詳細

Container

メソッドの詳細

getComponentCount

countComponents

getComponent

getComponents

getInsets

insets

add

add

add

setComponentZOrder

getComponentZOrder

add

add

addImpl

remove

remove

removeAll

getLayout

setLayout

doLayout

layout

isValidateRoot

invalidate

validate

validateTree

setFont

getPreferredSize

preferredSize

getMinimumSize

minimumSize

getMaximumSize

getAlignmentX

getAlignmentY

paint

update

print

paintComponents

printComponents

addContainerListener

removeContainerListener

getContainerListeners

getListeners

processEvent

processContainerEvent

deliverEvent

getComponentAt

locate

getComponentAt

getMousePosition

findComponentAt

findComponentAt

addNotify

removeNotify

isAncestorOf

paramString

list

list

setFocusTraversalKeys

getFocusTraversalKeys

areFocusTraversalKeysSet

isFocusCycleRoot

setFocusTraversalPolicy

getFocusTraversalPolicy

isFocusTraversalPolicySet

setFocusCycleRoot

isFocusCycleRoot

setFocusTraversalPolicyProvider