JavaTM 2
Platform
Std. Ed. v1.4.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

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

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

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

入れ子クラスの概要
protected  class Container.AccessibleAWTContainer
          ユーザ補助機能のデフォルトサポートの提供に使用する Container の内部クラスです。
 
クラス java.awt.Component から継承した入れ子クラス
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()
          コンテナ内のすべてのコンポーネントを返します。
 ContainerListener[] getContainerListeners()
          このコンテナに登録されているすべての項目リスナーの配列を返します。
 Set getFocusTraversalKeys(int id)
          このコンテナの指定されたトラバーサル操作のフォーカストラバーサルキーのセットを返します。
 FocusTraversalPolicy getFocusTraversalPolicy()
          このコンテナの子のキーボードトラバーサルを管理するフォーカストラバーサルポリシーを返します。
 Insets getInsets()
          コンテナの境界のサイズを示す、このコンテナのインセットを判定します。
 LayoutManager getLayout()
          このコンテナのレイアウトマネージャを返します。
 EventListener[] getListeners(Class listenerType)
          この ContainerFooListener として現在登録されているすべてのオブジェクトの配列を返します。
 Dimension getMaximumSize()
          このコンテナの最大サイズを返します。
 Dimension getMinimumSize()
          このコンテナの最小サイズを返します。
 Dimension getPreferredSize()
          このコンテナの推奨サイズを返します。
 Insets insets()
          推奨されていません。 JDK バージョン 1.1 以降は、getInsets() を使用
 void invalidate()
          コンテナを無効にします。
 boolean isAncestorOf(Component c)
          コンポーネントがこのコンテナのコンポーネント階層に格納されているかどうかを判定します。
 boolean isFocusCycleRoot()
          このコンテナがフォーカストラバーサルサイクルのルートであるかどうかを返します。
 boolean isFocusCycleRoot(Container container)
          指定されたコンテナが、このコンテナのフォーカストラバーサルサイクルのフォーカスサイクルルートであるかどうかを返します。
 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 setFocusCycleRoot(boolean focusCycleRoot)
          このコンテナがフォーカストラバーサルサイクルのルートであるかどうかを設定します。
 void setFocusTraversalKeys(int id, Set keystrokes)
          このコンテナの指定されたトラバーサル操作に対するフォーカストラバーサルキーを設定します。
 void setFocusTraversalPolicy(FocusTraversalPolicy policy)
          このコンテナがフォーカスサイクルルートの場合、このコンテナの子のキーボートトラバーサルを管理するフォーカストラバーサルポリシーを設定します。
 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, 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, 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, isOpaque, 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, setName, 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

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

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


add

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

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

add

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

このメソッドは 1.1 から無効になっています。代わりに 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)

add

public void add(Component comp,
                Object constraints)
指定されたコンポーネントをコンテナの末尾に追加します。また、指定された制約オブジェクトを使用して、このコンテナの配置にコンポーネントを追加することをレイアウトマネージャに通知します。これは の簡易メソッドです。

パラメータ:
comp - 追加されるコンポーネント
constraints - このコンポーネントの配置条件を表現するオブジェクト
導入されたバージョン:
JDK1.1
関連項目:
addImpl(java.awt.Component, java.lang.Object, int), 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), remove(int), LayoutManager

addImpl

protected void addImpl(Component comp,
                       Object constraints,
                       int index)
指定されたコンポーネントをコンテナのインデックスで指定された位置に追加します。また、指定された制約オブジェクトを使用してこのコンテナの配置に addLayoutComponent メソッドでコンポーネントを追加することをレイアウトマネージャに通知します。制約は使用されているレイアウトマネージャを使用して定義されます。たとえば BorderLayout クラスは、BorderLayout.NORTHBorderLayout.SOUTHBorderLayout.EASTBorderLayout.WEST、および BorderLayout.CENTER の 5 つの制限を定義します。

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

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

super.addImpl(comp, constraints, index)

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

remove

public void remove(int index)
コンテナから、index で指定されたコンポーネントを削除します。

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

remove

public void remove(Component comp)
コンテナから、指定されたコンポーネントを削除します。

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

removeAll

public void removeAll()
コンテナからすべてのコンポーネントを削除します。

関連項目:
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

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

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

invalidate

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

オーバーライド:
クラス Component 内の invalidate
関連項目:
validate(), layout(), LayoutManager

validate

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

AWT は validate を使用して、コンテナが格納しているコンポーネントが追加または変更されたあとで、コンテナがそのサブコンポーネントを、もう一度配置できるようにします。

オーバーライド:
クラス Component 内の validate
関連項目:
validate(), Component.invalidate()

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

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

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 EventListener[] getListeners(Class listenerType)
この ContainerFooListener として現在登録されているすべてのオブジェクトの配列を返します。この FooListeneraddFooListener メソッドで登録されたものです。

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

ContainerListener[] cls = (ContainerListener[])(c.getListeners(ContainerListener.class));
このようなリスナーがない場合は空の配列を返します。

オーバーライド:
クラス Component 内の getListeners
パラメータ:
listenerType - 要求されるリスナーのタイプ。java.util.EventListener の下位インタフェースを指定
戻り値:
このコンテナに FooListener として登録されているすべてのオブジェクトの配列。リスナーが登録されていない場合は空の配列を返す
例外:
ClassCastException - listenerTypejava.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 オブジェクトにディスパッチすることで処理します。このメソッドは、このコンポーネントのコンテナイベントが有効になった時点で呼び出されます。コンテナイベントは次が発生したときに有効になります。

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

パラメータ:
e - コンテナイベント
関連項目:
Component.enableEvents(long)

deliverEvent

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

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)

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。要求された点に子コンポーネントがなく、点がコンテナの境界内にある場合は、コンテナ自身が返される
導入されたバージョン:
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)
指定された出力ストリームにこのコンテナのリストを出力します。リストは、指定されたインデント位置から開始されます。

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

list

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

オーバーライド:
クラス Component 内の list
パラメータ:
out - 出力先のプリントライター
indent - インデントされるスペースの数
関連項目:
PrintStream.println(java.lang.Object)

setFocusTraversalKeys

public void setFocusTraversalKeys(int id,
                                  Set keystrokes)
このコンテナの指定されたトラバーサル操作に対するフォーカストラバーサルキーを設定します。

コンテナのフォーカストラバーサルキーのデフォルト値は実装によって異なります。サン・マイクロシステムズ社では、1 つのネイティブプラットフォームでは同じデフォルト値の使用をお勧めしています。Windows および Unix 環境での推奨値を次に記載します。これらは Sun AWT の実装に使用されます。
ID 意味 デフォルト
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 を指定できるようになり、フォーカストラバーサルを操作できるようになります。ただし、指定されるキーイベントに関係なく、関連付けられる 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 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

isFocusCycleRoot

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

戻り値:
このコンテナがフォーカストラバーサルサイクルのルートであるかどうか
導入されたバージョン:
1.4
関連項目:
setFocusCycleRoot(boolean), setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), getFocusTraversalPolicy(), ContainerOrderFocusTraversalPolicy

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 をリスナーリストに追加します。リスナーは次を含む、このクラスのすべてのバウンドプロパティに対して登録されます。 このコンテナがバウンドプロパティを継承する場合、継承されるプロパティの変更に反応してイベントがトリガされることはありません。

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 を指定されたプロパティのリスナーリストに追加します。ユーザ定義のプロパティ、または次のデフォルトを指定できます。 このコンテナがバウンドプロパティを継承する場合、継承されるプロパティの変更に反応してイベントがトリガされることはありません。

listener が null の場合は、例外はスローされず、何も処理は行われません。

オーバーライド:
クラス Component 内の addPropertyChangeListener
パラメータ:
propertyName - 上記のプロパティ名のどれか
listener - 追加する PropertyChangeListener
関連項目:
addPropertyChangeListener(java.beans.PropertyChangeListener), Component.removePropertyChangeListener(java.beans.PropertyChangeListener)

JavaTM 2
Platform
Std. Ed. v1.4.0

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

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.