Container (Java 2 Platform SE 5.0)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM 2 Platform
Standard Ed. 5.0

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

java.awt
クラス Container

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
extends Component

一般的な Abstract Window Toolkit (AWT) コンテナオブジェクトは、ほかの AWT コンポーネントを含むことができるコンポーネントです。

コンテナに追加されるコンポーネントはリスト中に入れられます。リストの順番は、コンテナ中の前面から後面へコンポーネントがスタックされる順番を表します。コンテナにコンポーネントを追加するときにインデックスが指定されないと、リストの最後尾に追加され、最後尾にスタックされます。

注: フォーカスサブシステムの詳細については、「How to Use the Focus Subsystem」、「The Java Tutorial」のセクション、「Focus Specification」を参照してください。

導入されたバージョン:: JDK1.0
関連項目:: add(java.awt.Component, int), getComponent(int), LayoutManager, 直列化された形式

入れ子のクラスの概要
`protected class`	`Container.AccessibleAWTContainer` ユーザ補助機能のデフォルトサポートの提供に使用する Container の内部クラスです。

クラス java.awt.Component から継承された入れ子のクラス/インタフェース
`Component.AccessibleAWTComponent, 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()` 新しいコンテナを構築します。

メソッドの概要

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 バージョン 1.1 以降は、getComponentCount() を使用します。

void deliverEvent(Event e)
推奨されていません。 JDK バージョン 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()
このコンテナの子のキーボードトラバーサルを管理するフォーカストラバーサルポリシーを返します。

Insets getInsets()
コンテナの境界のサイズを示す、このコンテナのインセットを判定します。

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





<T extends EventListener> 


T[]

getListeners(Class<T> listenerType)
この Container に FooListener として現在登録されているすべてのオブジェクトの配列を返します。

Dimension getMaximumSize()
このコンテナの最大サイズを返します。

Dimension getMinimumSize()
このコンテナの最小サイズを返します。

Point getMousePosition(boolean allowChildren)
Container がマウスポインタの下にある場合、この Container の座標空間のマウスポインタの位置を返し、そうでない場合は、null を返します。

Dimension getPreferredSize()
このコンテナの推奨サイズを返します。

Insets insets()
推奨されていません。 JDK バージョン 1.1 以降は、getInsets() を使用します。

void invalidate()
コンテナを無効にします。

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

boolean isFocusCycleRoot()
このコンテナがフォーカストラバーサルサイクルのルートであるかどうかを返します。

boolean isFocusCycleRoot(Container container)
指定されたコンテナが、このコンテナのフォーカストラバーサルサイクルのフォーカスサイクルルートであるかどうかを返します。

boolean isFocusTraversalPolicyProvider()
このコンテナがフォーカストラバーサルポリシーを提供するかどうかを返します。

boolean isFocusTraversalPolicySet()
フォーカストラバーサルポリシーがこのコンテナに対して明示的に設定されているかどうかを設定します。

void layout()
推奨されていません。 JDK バージョン 1.1 以降は、doLayout() を使用します。

void list(PrintStream out, int indent)
指定された出力ストリームにこのコンテナのリストを出力します。

void list(PrintWriter out, int indent)
指定されたインデント位置から開始して、指定されたプリントライターにリストを出力します。

Component locate(int x, int y)
推奨されていません。 JDK バージョン 1.1 以降は、getComponentAt(int, int) を使用します。

Dimension minimumSize()
推奨されていません。 JDK バージョン 1.1 以降は、getMinimumSize() を使用します。

void paint(Graphics g)
コンテナをペイントします。

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

protected String paramString()
この Container の状態を表す文字列を返します。

Dimension preferredSize()
推奨されていません。 JDK バージョン 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 transferFocusBackward()
このコンポーネントがフォーカス所有者であるかのように、フォーカスを前のコンポーネントに転送します。

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, 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, 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, transferFocusUpCycle

クラス 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, 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, 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, transferFocusUpCycle

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

コンストラクタの詳細

Container

public Container()

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

メソッドの詳細

getComponentCount

public int getComponentCount()

このパネル内のコンポーネントの数を返します。

戻り値:: このパネルのコンポーネント数
導入されたバージョン:: JDK1.1
関連項目:: getComponent(int)

countComponents

@Deprecated
public int countComponents()

推奨されていません。 JDK バージョン 1.1 以降は、getComponentCount() を使用します。

getComponent

public Component getComponent(int n)

コンテナ内の n 番目のコンポーネントを返します。

パラメータ:: n - 取得するコンポーネントのインデックス
戻り値:: このコンテナ内の n 番目のコンポーネント
例外:: ArrayIndexOutOfBoundsException - n 番目の値がない場合

getComponents

public Component[] getComponents()

コンテナ内のすべてのコンポーネントを返します。

戻り値:: このコンテナ内のすべてのコンポーネントの配列

getInsets

public Insets getInsets()

コンテナの境界のサイズを示す、このコンテナのインセットを判定します。

たとえば、Frame オブジェクトは、フレームのタイトルバーの高さに対応する上のインセットを持ちます。

戻り値:: このコンテナのインセット
導入されたバージョン:: JDK1.1
関連項目:: Insets, LayoutManager

insets

@Deprecated
public Insets insets()

推奨されていません。 JDK バージョン 1.1 以降は、getInsets() を使用します。

add

public Component add(Component comp)

指定されたコンポーネントをこのコンテナの最後に追加します。これは addImpl(java.awt.Component, java.lang.Object, int) の簡易メソッドです。

注: コンポーネントを、表示されているコンテナに追加した場合、そのコンテナに対して validate を呼び出し、新しいコンポーネントを表示する必要があります。複数のコンポーネントを追加する場合は、すべてのコンポーネントを追加したあとで、validate を 1 回だけ呼び出すことによって、効率を向上できます。

パラメータ:: comp - 追加されるコンポーネント
戻り値:: コンポーネント引数
関連項目:: addImpl(java.awt.Component, java.lang.Object, int), validate(), JComponent.revalidate()

add

public Component add(String name,
                     Component comp)

指定されたコンポーネントをこのコンテナに追加します。これは addImpl(java.awt.Component, java.lang.Object, int) の簡易メソッドです。

このメソッドは 1.1 から無効になっています。代わりに add(Component, Object) メソッドを使用してください。

関連項目:: add(Component, Object)

add

public Component add(Component comp,
                     int index)

指定されたコンポーネントをこのコンテナの指定された位置に追加します。これは addImpl(java.awt.Component, java.lang.Object, int) の簡易メソッドです。

パラメータ:: comp - 追加されるコンポーネント; index - コンポーネントを挿入する位置。コンポーネントを最後に挿入する場合は -1
戻り値:: コンポーネント comp
関連項目:: addImpl(java.awt.Component, java.lang.Object, int), remove(int), validate(), JComponent.revalidate()

setComponentZOrder

public final 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)

getComponentZOrder

public final 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 - このコンポーネントの配置条件を表現するオブジェクト
導入されたバージョン:: JDK1.1
関連項目:: addImpl(java.awt.Component, java.lang.Object, int), 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 は最後に挿入することを意味する
関連項目:: addImpl(java.awt.Component, java.lang.Object, int), 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 が発生します。

レイアウトマネージャが LayoutManager インタフェースと LayoutManager2 インタフェースの両方を実装する場合、LayoutManager2 メソッドを呼び出します。

コンポーネントがこのコンテナ、またはその子に登録済の場合、このコンテナに追加する前に削除されます。

これは、プログラムがコンテナへのすべての追加要求を追跡する必要がある場合にオーバーライドするメソッドです。他のすべての追加メソッドでは追跡を行いません。オーバーライドするメソッドは、通常、メソッドのスーパークラスのバージョンの呼び出しを含む必要があります。

super.addImpl(comp, constraints, index)

パラメータ:: comp - 追加されるコンポーネント; constraints - このコンポーネントの配置制約を表現するオブジェクト; index - コンポーネントを挿入するコンテナのリスト内での位置。-1 は最後に挿入することを意味する
例外:: IllegalArgumentException - index が無効な場合; IllegalArgumentException - コンテナの親をそのコンテナ自体に追加しようとしている場合; IllegalArgumentException - comp が Container に複数回追加された場合; IllegalArgumentException - ウィンドウをコンテナに追加しようとしている場合
導入されたバージョン:: JDK1.1
関連項目:: add(Component), add(Component, int), add(Component, java.lang.Object), LayoutManager, LayoutManager2

remove

public void remove(int index)

index によって指定されたコンポーネントをこのコンテナから削除します。さらにこのメソッドは、removeLayoutComponent メソッドを使用して、このコンテナのレイアウトからコンポーネントを削除することをレイアウトマネージャに通知します。

パラメータ:: index - 削除されるコンポーネントのインデックス
導入されたバージョン:: JDK1.1
関連項目:: add(java.awt.Component)

remove

public void remove(Component comp)

指定されたコンポーネントをこのコンテナから削除します。さらにこのメソッドは、removeLayoutComponent メソッドを使用して、このコンテナのレイアウトからコンポーネントを削除することをレイアウトマネージャに通知します。

パラメータ:: comp - 削除されるコンポーネント
関連項目:: add(java.awt.Component), remove(int)

removeAll

public void removeAll()

すべてのコンポーネントをこのコンテナから削除します。さらにこのメソッドは、removeLayoutComponent メソッドを使用して、このコンテナのレイアウトからコンポーネントを削除することをレイアウトマネージャに通知します。

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

getLayout

public LayoutManager getLayout()

このコンテナのレイアウトマネージャを返します。

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

setLayout

public void setLayout(LayoutManager mgr)

このコンテナのレイアウトマネージャを設定します。

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

doLayout

public void doLayout()

このコンテナがコンポーネントを配置できるようにします。ほとんどのプログラムでは、このメソッドを直接呼び出す代わりに、validate メソッドを呼び出す必要があります。

オーバーライド:: クラス Component 内の doLayout

導入されたバージョン:: JDK1.1
関連項目:: LayoutManager.layoutContainer(java.awt.Container), setLayout(java.awt.LayoutManager), validate()

layout

@Deprecated
public void layout()

推奨されていません。 JDK バージョン 1.1 以降は、doLayout() を使用します。

オーバーライド:: クラス Component 内の layout

invalidate

public void invalidate()

コンテナを無効にします。上記のコンテナとすべての親は、配置される必要があるものとしてマークされます。このメソッドは頻繁に呼び出されるので、迅速に動作する必要があります。

オーバーライド:: クラス Component 内の invalidate

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

validate

public void validate()

このコンテナおよびすべてのサブコンポーネントを検証します。

validate メソッドを使用して、コンテナに再びそのサブコンポーネントを配置させます。このコンテナが表示されてから、コンテナのサブコンポーネントが変更された (コンテナへの追加または削除、レイアウト関連の情報の変更) 場合に呼び出す必要があります。

オーバーライド:: クラス Component 内の validate

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

validateTree

protected void validateTree()

コンテナツリーを再帰的に下位までたどり、必要であるとマークされたすべてのサブツリー、そして無効とマークされたすべてのサブツリーの配置を再計算します。同期化は、この validate を呼び出すメソッドによって提供される必要があります。

setFont

public void setFont(Font f)

このコンテナのフォントを設定します。

オーバーライド:: クラス Component 内の setFont

パラメータ:: f - このコンテナのフォントとして設定するフォント
導入されたバージョン:: JDK1.0
関連項目:: Component.getFont()

getPreferredSize

public Dimension getPreferredSize()

このコンテナの推奨サイズを返します。

オーバーライド:: クラス Component 内の getPreferredSize

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

preferredSize

@Deprecated
public Dimension preferredSize()

推奨されていません。 JDK バージョン 1.1 以降は、getPreferredSize() を使用します。

オーバーライド:: クラス Component 内の preferredSize

getMinimumSize

public Dimension getMinimumSize()

このコンテナの最小サイズを返します。

オーバーライド:: クラス Component 内の getMinimumSize

戻り値:: このコンテナの最小サイズを表す Dimension のインスタンス
導入されたバージョン:: JDK1.1
関連項目:: getPreferredSize(), getLayout(), LayoutManager.minimumLayoutSize(Container), Component.getMinimumSize()

minimumSize

@Deprecated
public Dimension minimumSize()

推奨されていません。 JDK バージョン 1.1 以降は、getMinimumSize() を使用します。

オーバーライド:: クラス Component 内の minimumSize

getMaximumSize

public Dimension getMaximumSize()

このコンテナの最大サイズを返します。

オーバーライド:: クラス Component 内の getMaximumSize

戻り値:: このコンポーネントの最大サイズを示す寸法オブジェクト
関連項目:: getPreferredSize()

getAlignmentX

public float getAlignmentX()

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

オーバーライド:: クラス Component 内の getAlignmentX

getAlignmentY

public float getAlignmentY()

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

オーバーライド:: クラス Component 内の getAlignmentY

paint

public void paint(Graphics g)

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

オーバーライド:: クラス Component 内の paint

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

update

public void update(Graphics g)

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

オーバーライド:: クラス Component 内の update

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

print

public void print(Graphics g)

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

オーバーライド:: クラス Component 内の print

パラメータ:: 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 の場合、例外はスローされず、処理も実行されません。

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

removeContainerListener

public void removeContainerListener(ContainerListener l)

このコンテナからのコンテナイベントを受け取らないように、指定されたコンテナリスナーを削除します。l が null の場合、例外はスローされず、処理も実行されません。

パラメータ:: 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 メソッドで登録されたものです。

listenerType 引数は FooListener.class のようなクラスリテラルで指定できます。たとえば、このコンテナリスナーに対する Container c の照会は次のコードで行います。

ContainerListener[] cls = (ContainerListener[])(c.getListeners(ContainerListener.class));

このようなリスナーがない場合は空の配列を返します。

オーバーライド:: クラス Component 内の getListeners

パラメータ:: listenerType - 要求されるリスナーの型。java.util.EventListener の下位インタフェースを指定
戻り値:: このコンテナに FooListener として登録されているすべてのオブジェクトの配列。リスナーが登録されていない場合は空の配列を返す
例外:: ClassCastException - listenerType が java.util.EventListener を実装するクラスまたはインタフェースを指定しない場合
導入されたバージョン:: 1.3
関連項目:: getContainerListeners()

processEvent

protected void processEvent(AWTEvent e)

このコンテナのイベントを処理します。イベントが ContainerEvent である場合、processContainerEvent メソッドを呼び出します。そうでない場合は、スーパークラスの processEvent を呼び出します。

イベントパラメータが null の場合の動作は定義されていないため例外がスローされます。

オーバーライド:: クラス Component 内の processEvent

パラメータ:: 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 バージョン 1.1 以降は、dispatchEvent(AWTEvent e) を使用します。

オーバーライド:: クラス Component 内の deliverEvent

getComponentAt

public Component getComponentAt(int x,
                                int y)

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

オーバーライド:: クラス Component 内の getComponentAt

パラメータ:: x - x 座標; y - y 座標
戻り値:: コンポーネントがその点を含まない場合は null。要求された点に子コンポーネントがなく、その点がコンテナの境界内にある場合は、コンテナ自身が返される。そうでない場合は、最上部の子コンポーネントが返される
導入されたバージョン:: JDK1.1
関連項目:: Component.contains(int, int)

locate

@Deprecated
public Component locate(int x,
                                   int y)

推奨されていません。 JDK バージョン 1.1 以降は、getComponentAt(int, int) を使用します。

オーバーライド:: クラス Component 内の locate

getComponentAt

public Component getComponentAt(Point p)

指定された点を含むコンポーネントを返します。

オーバーライド:: クラス Component 内の getComponentAt

パラメータ:: p - 点
戻り値:: 指定された点を含むコンポーネント。コンポーネントがその点を含まない場合は null
導入されたバージョン:: JDK1.1
関連項目:: Component.contains(int, int)

getMousePosition

public Point getMousePosition(boolean allowChildren)
                       throws HeadlessException

Container がマウスポインタの下にある場合、この Container の座標空間のマウスポインタの位置を返し、そうでない場合は、null を返します。このメソッドは、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 の場合、このメソッドは、もっとも深く入れ子になっている子コンポーネントを検索します。可視でないコンポーネントは検索時に無視されます。

パラメータ:: p - 点
戻り値:: コンポーネントがその位置を含まない場合は null。要求された点に子コンポーネントがなく、点がコンテナの境界内にある場合は、コンテナ自身が返される
導入されたバージョン:: 1.2
関連項目:: Component.contains(int, int), getComponentAt(int, int)

addNotify

public void addNotify()

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

オーバーライド:: クラス Component 内の addNotify

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

removeNotify

public void removeNotify()

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

オーバーライド:: クラス Component 内の removeNotify

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

isAncestorOf

public boolean isAncestorOf(Component c)

コンポーネントがこのコンテナのコンポーネント階層に格納されているかどうかを判定します。

パラメータ:: c - コンポーネント
戻り値:: 上位オブジェクトである場合は true、そうでない場合は false
導入されたバージョン:: JDK1.1

paramString

protected String paramString()

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

オーバーライド:: クラス Component 内の paramString

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

list

public void list(PrintStream out,
                 int indent)

指定された出力ストリームにこのコンテナのリストを出力します。リストは、指定されたインデント位置から開始されます。

コンテナの直接の子は indent+1 のインデント位置で出力されます。これらの子の子は indent+2、以下同様に出力されます。

オーバーライド:: クラス Component 内の list

パラメータ:: out - 出力ストリーム; indent - インデントされるスペースの数
導入されたバージョン:: JDK1.0
関連項目:: Component.list(java.io.PrintStream, int)

list

public void list(PrintWriter out,
                 int indent)

指定されたインデント位置から開始して、指定されたプリントライターにリストを出力します。

コンテナの直接の子は indent+1 のインデント位置で出力されます。これらの子の子は indent+2、以下同様に出力されます。

オーバーライド:: クラス Component 内の list

パラメータ:: out - プリントライター; indent - インデントされるスペースの数
導入されたバージョン:: JDK1.1
関連項目:: Component.list(java.io.PrintWriter, int)

setFocusTraversalKeys

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

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

コンテナのフォーカストラバーサルキーのデフォルト値は実装によって異なります。サン・マイクロシステムズ社では、1 つのネイティブプラットフォームでは同じデフォルト値の使用をお勧めしています。Windows および Unix 環境での推奨値を次に記載します。これらは Sun AWT の実装に使用されます。

識別子	意味	デフォルト
KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS	通常の順方向キーボードトラバーサル	KEY_PRESSED 上の TAB、KEY_PRESSED 上の CTRL-TAB
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS	通常のリバースキーボードトラバーサル	KEY_PRESSED の SHIFT-TAB、KEY_PRESSED の CTRL-SHIFT-TAB
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 のデフォルトセットが使用されます。

オーバーライド:: クラス Component 内の setFocusTraversalKeys

パラメータ:: id - 次のいずれか 1 つ。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 のデフォルトセットが返されます。

オーバーライド:: クラス Component 内の getFocusTraversalKeys

パラメータ:: id - 次のいずれか 1 つ。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), 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 から継承します。

オーバーライド:: クラス Component 内の areFocusTraversalKeysSet

パラメータ:: id - 次のいずれか 1 つ。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 を返します。

オーバーライド:: クラス Component 内の isFocusCycleRoot

パラメータ:: container - 判定対象の Container
戻り値:: 指定されたコンテナがこのコンテナのフォーカスサイクルルートの場合は true、そうでない場合は false
導入されたバージョン:: 1.4
関連項目:: isFocusCycleRoot()

transferFocusBackward

public void transferFocusBackward()

クラス Component の記述:

このコンポーネントがフォーカス所有者であるかのように、フォーカスを前のコンポーネントに転送します。

オーバーライド:: クラス Component 内の transferFocusBackward

関連項目:: Component.requestFocus()

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 に設定したコンテナを使用して、最も近い上位フォーカスサイクルルートの代わりに、フォーカストラバーサルポリシーを取得します。

パラメータ:: provide - このコンテナを使用して、フォーカストラバーサルポリシーを提供するかどうかを指定する
導入されたバージョン:: 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 プロパティを設定します。

オーバーライド:: クラス Component 内の applyComponentOrientation

パラメータ:: o - このコンテナと含まれるすべてのコンポーネントの新しいコンポーネント方向
例外:: NullPointerException - orientation が null の場合
導入されたバージョン:: 1.4
関連項目:: Component.setComponentOrientation(java.awt.ComponentOrientation), Component.getComponentOrientation()

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 の場合は、例外はスローされず、何も処理はありません。

オーバーライド:: クラス Component 内の addPropertyChangeListener

パラメータ:: 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 の場合は、例外はスローされず、何も処理はありません。

オーバーライド:: クラス Component 内の addPropertyChangeListener

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

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM 2 Platform
Standard Ed. 5.0

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

java.awt クラス Container

Container

getComponentCount

countComponents

getComponent

getComponents

getInsets

insets

add

add

add

setComponentZOrder

getComponentZOrder

add

add

addImpl

remove

remove

removeAll

getLayout

setLayout

doLayout

layout

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

transferFocusBackward

setFocusTraversalPolicy

getFocusTraversalPolicy

isFocusTraversalPolicySet

setFocusCycleRoot

isFocusCycleRoot

setFocusTraversalPolicyProvider

isFocusTraversalPolicyProvider

transferFocusDownCycle

applyComponentOrientation

addPropertyChangeListener

addPropertyChangeListener

java.awt
クラス Container