Container (Java Platform SE 6)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM Platform
Standard Ed. 6

前のクラス 次のクラス

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

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

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

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.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()` 新しいコンテナを構築します。

メソッドの概要

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()
このコンテナの子のキーボードトラバーサルを管理するフォーカストラバーサルポリシーを返します。

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 Version 1.1 以降は、getInsets() に置き換えられました。

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

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

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

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

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

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

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 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, 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, 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, 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, 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 version 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 Version 1.1 以降は、getInsets() に置き換えられました。

add

public Component add(Component comp)

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

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

パラメータ:: comp - 追加されるコンポーネント
戻り値:: コンポーネント引数
例外:: NullPointerException - comp が null の場合
関連項目:: 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) メソッドを使用してください。

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

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

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), 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), 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), LayoutManager, LayoutManager2

remove

public void remove(int index)

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

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

パラメータ:: index - 削除されるコンポーネントのインデックス
例外:: ArrayIndexOutOfBoundsException - index が [0, getComponentCount()-1] の範囲内にない場合
導入されたバージョン:: JDK1.1
関連項目:: add(java.awt.Component), validate(), getComponentCount()

remove

public void remove(Component comp)

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

パラメータ:: comp - 削除されるコンポーネント
関連項目:: add(java.awt.Component), validate(), 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 Version 1.1 以降は、doLayout() に置き換えられました。

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

invalidate

public void invalidate()

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

このコンテナにインストールされている LayoutManager が LayoutManager2 のインスタンスである場合は、この Container を引数として LayoutManager2.invalidateLayout(Container) が呼び出されます。

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

関連項目:: validate(), layout(), LayoutManager, LayoutManager2.invalidateLayout(Container)

validate

public void validate()

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

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

この Container が有効でない場合、このメソッドは Container メソッドを呼び出し、この Container を有効としてマークします。それ以外の場合は、何の処理も行いません。

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

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

validateTree

protected void validateTree()

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

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

setFont

public void setFont(Font f)

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

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

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

getPreferredSize

public Dimension getPreferredSize()

このコンテナの推奨サイズを返します。推奨サイズが Component.setPreferredSize(Dimension) によって明示的に設定されていない場合で、この Container に non-null LayoutManager があるときは、LayoutManager.preferredLayoutSize(Container) を使用して推奨サイズが計算されます。

注:実装によっては、LayoutManager の戻り値をキャッシュする場合があります。そのような実装では、このメソッドが呼び出されるたびに LayoutManager の preferredLayoutSize を呼び出す必要はなく、Container が無効になったときだけ LayoutManager を照会します。

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

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

preferredSize

@Deprecated
public Dimension preferredSize()

推奨されていません。 JDK Version 1.1 以降は、getPreferredSize() に置き換えられました。

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

getMinimumSize

public Dimension getMinimumSize()

このコンテナの最小サイズを返します。最小サイズが Component.setMinimumSize(Dimension) によって明示的に設定されていない場合で、この Container に non-null LayoutManager があるときは、LayoutManager.minimumLayoutSize(Container) を使用して最小サイズが計算されます。

注:実装によっては、LayoutManager の戻り値をキャッシュする場合があります。そのような実装では、このメソッドが呼び出されるたびに LayoutManager の minimumLayoutSize を呼び出す必要はなく、Container が無効になったときだけ LayoutManager を照会します。

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

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

minimumSize

@Deprecated
public Dimension minimumSize()

推奨されていません。 JDK Version 1.1 以降は、getMinimumSize() に置き換えられました。

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

getMaximumSize

public Dimension getMaximumSize()

このコンテナの最大サイズを返します。最大サイズが Component.setMaximumSize(Dimension) によって明示的に設定されていない場合で、この Container にインストールされている LayoutManager が LayoutManager2 のインスタンスであるときは、LayoutManager2.maximumLayoutSize(Container) を使用して最大サイズが計算されます。

注:実装によっては、LayoutManager2 の戻り値をキャッシュする場合があります。そのような実装では、このメソッドが呼び出されるたびに LayoutManager2 の maximumLayoutSize を呼び出す必要はなく、Container が無効になったときだけ LayoutManager2 を照会します。

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

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

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

AWT スレッドモデルの詳細については、「AWT Threading Issues」を参照してください。

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

removeContainerListener

public void removeContainerListener(ContainerListener l)

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

AWT スレッドモデルの詳細については、「AWT Threading Issues」を参照してください。

パラメータ:: 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));

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

オーバーライド:: クラス 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 Version 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 Version 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)

パラメータ:: 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)

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

コンテナのフォーカストラバーサルキーのデフォルト値は実装によって異なります。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 つ上のフォーカストラバーサルサイクルに移動	none
KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS		1 つ下のフォーカストラバーサルサイクルに移動	none

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

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

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

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

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

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

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

パラメータ:: 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 プロパティーを設定します。

オーバーライド:: クラス 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 Platform
Standard Ed. 6

前のクラス 次のクラス

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

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

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

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 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