|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object java.awt.Component java.awt.Container
public class Container
一般的な Abstract Window Toolkit (AWT) コンテナオブジェクトは、ほかの AWT コンポーネントを含むことができるコンポーネントです。
コンテナに追加されるコンポーネントはリスト中に入れられます。リストの順番は、コンテナ中の前面から後面へコンポーネントがスタックされる順番を表します。コンテナにコンポーネントを追加するときにインデックスが指定されないと、リストの最後尾に追加され、最後尾にスタックされます。
注: フォーカスサブシステムの詳細については、「How to Use the Focus Subsystem」、「The Java Tutorial」のセクション、「Focus Specification」を参照してください。
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()
このコンテナのレイアウトマネージャを返します。 |
|
|
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.lang.Object から継承されたメソッド |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
コンストラクタの詳細 |
---|
public Container()
メソッドの詳細 |
---|
public int getComponentCount()
getComponent(int)
@Deprecated public int countComponents()
public Component getComponent(int n)
n
- 取得するコンポーネントのインデックス
ArrayIndexOutOfBoundsException
- n 番目の値がない場合public Component[] getComponents()
public Insets getInsets()
たとえば、Frame
オブジェクトは、フレームのタイトルバーの高さに対応する上のインセットを持ちます。
Insets
,
LayoutManager
@Deprecated public Insets insets()
getInsets()
を使用します。
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()
public Component add(String name, Component comp)
addImpl(java.awt.Component, java.lang.Object, int)
の簡易メソッドです。
このメソッドは 1.1 から無効になっています。代わりに add(Component, Object)
メソッドを使用してください。
add(Component, Object)
public Component add(Component comp, int index)
addImpl(java.awt.Component, java.lang.Object, int)
の簡易メソッドです。
注: コンポーネントを、表示されているコンテナに追加した場合、そのコンテナに対して validate
を呼び出し、新しいコンポーネントを表示する必要があります。複数のコンポーネントを追加する場合は、すべてのコンポーネントを追加したあとで、validate
を 1 回だけ呼び出すことによって、効率を向上できます。
comp
- 追加されるコンポーネントindex
- コンポーネントを挿入する位置。コンポーネントを最後に挿入する場合は -1
comp
addImpl(java.awt.Component, java.lang.Object, int)
,
remove(int)
,
validate()
,
JComponent.revalidate()
public final void setComponentZOrder(Component comp, int index)
コンポーネントが他のコンテナの子である場合、このコンテナに追加される前にそのコンテナから削除されます。このメソッドと 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
をコンテナに追加しようとしている場合getComponentZOrder(java.awt.Component)
public final int getComponentZOrder(Component comp)
comp
- 照会用のコンポーネント
null
またはコンテナに属さない場合は -1 を返すsetComponentZOrder(java.awt.Component, int)
public void add(Component comp, Object constraints)
addImpl(java.awt.Component, java.lang.Object, int)
の簡易メソッドです。
注: コンポーネントを、表示されているコンテナに追加した場合、そのコンテナに対して validate
を呼び出し、新しいコンポーネントを表示する必要があります。複数のコンポーネントを追加する場合は、すべてのコンポーネントを追加したあとで、validate
を 1 回だけ呼び出すことによって、効率を向上できます。
comp
- 追加されるコンポーネントconstraints
- このコンポーネントの配置条件を表現するオブジェクトaddImpl(java.awt.Component, java.lang.Object, int)
,
validate()
,
JComponent.revalidate()
,
LayoutManager
public void add(Component comp, Object constraints, int index)
addImpl(java.awt.Component, java.lang.Object, int)
の簡易メソッドです。
注: コンポーネントを、表示されているコンテナに追加した場合、そのコンテナに対して validate
を呼び出し、新しいコンポーネントを表示する必要があります。複数のコンポーネントを追加する場合は、すべてのコンポーネントを追加したあとで、validate
を 1 回だけ呼び出すことによって、効率を向上できます。
comp
- 追加されるコンポーネントconstraints
- このコンポーネントの配置条件を表現するオブジェクトindex
- コンポーネントを挿入するコンテナのリスト内の位置。-1
は最後に挿入することを意味するaddImpl(java.awt.Component, java.lang.Object, int)
,
validate()
,
JComponent.revalidate()
,
remove(int)
,
LayoutManager
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
- ウィンドウをコンテナに追加しようとしている場合add(Component)
,
add(Component, int)
,
add(Component, java.lang.Object)
,
LayoutManager
,
LayoutManager2
public void remove(int index)
index
によって指定されたコンポーネントをこのコンテナから削除します。さらにこのメソッドは、removeLayoutComponent
メソッドを使用して、このコンテナのレイアウトからコンポーネントを削除することをレイアウトマネージャに通知します。
index
- 削除されるコンポーネントのインデックスadd(java.awt.Component)
public void remove(Component comp)
removeLayoutComponent
メソッドを使用して、このコンテナのレイアウトからコンポーネントを削除することをレイアウトマネージャに通知します。
comp
- 削除されるコンポーネントadd(java.awt.Component)
,
remove(int)
public void removeAll()
removeLayoutComponent
メソッドを使用して、このコンテナのレイアウトからコンポーネントを削除することをレイアウトマネージャに通知します。
add(java.awt.Component)
,
remove(int)
public LayoutManager getLayout()
doLayout()
,
setLayout(java.awt.LayoutManager)
public void setLayout(LayoutManager mgr)
mgr
- 指定されたレイアウトマネージャdoLayout()
,
getLayout()
public void doLayout()
validate
メソッドを呼び出す必要があります。
Component
内の doLayout
LayoutManager.layoutContainer(java.awt.Container)
,
setLayout(java.awt.LayoutManager)
,
validate()
@Deprecated public void layout()
doLayout()
を使用します。
Component
内の layout
public void invalidate()
Component
内の invalidate
validate()
,
layout()
,
LayoutManager
public void validate()
validate
メソッドを使用して、コンテナに再びそのサブコンポーネントを配置させます。このコンテナが表示されてから、コンテナのサブコンポーネントが変更された (コンテナへの追加または削除、レイアウト関連の情報の変更) 場合に呼び出す必要があります。
Component
内の validate
add(java.awt.Component)
,
Component.invalidate()
,
JComponent.revalidate()
protected void validateTree()
validate
を呼び出すメソッドによって提供される必要があります。
public void setFont(Font f)
Component
内の setFont
f
- このコンテナのフォントとして設定するフォントComponent.getFont()
public Dimension getPreferredSize()
Component
内の getPreferredSize
Dimension
のインスタンスgetMinimumSize()
,
getLayout()
,
LayoutManager.preferredLayoutSize(Container)
,
Component.getPreferredSize()
@Deprecated public Dimension preferredSize()
getPreferredSize()
を使用します。
Component
内の preferredSize
public Dimension getMinimumSize()
Component
内の getMinimumSize
Dimension
のインスタンスgetPreferredSize()
,
getLayout()
,
LayoutManager.minimumLayoutSize(Container)
,
Component.getMinimumSize()
@Deprecated public Dimension minimumSize()
getMinimumSize()
を使用します。
Component
内の minimumSize
public Dimension getMaximumSize()
Component
内の getMaximumSize
getPreferredSize()
public float getAlignmentX()
Component
内の getAlignmentX
public float getAlignmentY()
Component
内の getAlignmentY
public void paint(Graphics g)
Component
内の paint
g
- 指定された Graphics ウィンドウComponent.update(Graphics)
public void update(Graphics g)
Component
内の update
g
- 指定された Graphics ウィンドウComponent.update(Graphics)
public void print(Graphics g)
Component
内の print
g
- 指定された Graphics ウィンドウComponent.update(Graphics)
public void paintComponents(Graphics g)
g
- グラフィックスコンテキストComponent.paint(java.awt.Graphics)
,
Component.paintAll(java.awt.Graphics)
public void printComponents(Graphics g)
g
- グラフィックスコンテキストComponent.print(java.awt.Graphics)
,
Component.printAll(java.awt.Graphics)
public void addContainerListener(ContainerListener l)
l
- コンテナリスナーremoveContainerListener(java.awt.event.ContainerListener)
,
getContainerListeners()
public void removeContainerListener(ContainerListener l)
l
- コンテナリスナーaddContainerListener(java.awt.event.ContainerListener)
,
getContainerListeners()
public ContainerListener[] getContainerListeners()
ContainerListener
。コンテナリスナーが現在登録されていない場合は空の配列を返すaddContainerListener(java.awt.event.ContainerListener)
,
removeContainerListener(java.awt.event.ContainerListener)
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
を実装するクラスまたはインタフェースを指定しない場合getContainerListeners()
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)
protected void processContainerEvent(ContainerEvent e)
addContainerListener
によって登録されているenableEvents
によってコンテナイベントが使用可能になっている
イベントパラメータが null
の場合の動作は定義されていないため例外がスローされます。
e
- コンテナイベントComponent.enableEvents(long)
@Deprecated public void deliverEvent(Event e)
dispatchEvent(AWTEvent e)
を使用します。
Component
内の deliverEvent
public Component getComponentAt(int x, int y)
Component
内の getComponentAt
x
- x 座標y
- y 座標
Component.contains(int, int)
@Deprecated public Component locate(int x, int y)
getComponentAt(int, int)
を使用します。
Component
内の locate
public Component getComponentAt(Point p)
Component
内の getComponentAt
p
- 点
null
Component.contains(int, int)
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 を返す場合Component.getMousePosition()
public Component findComponentAt(int x, int y)
findComponentAt メソッドは、Container の直接の子だけを検索する getComponentAt とは異なります。格納されているコンポーネントが Container の場合、findComponentAt はその子を検索して入れ子になっているコンポーネントを見つけます。
x
- x 座標y
- y 座標
Component.contains(int, int)
,
getComponentAt(int, int)
public Component findComponentAt(Point p)
findComponentAt メソッドは、Container の直接の子だけを検索する getComponentAt とは異なります。格納されているコンポーネントが Container の場合、findComponentAt はその子を検索して入れ子になっているコンポーネントを見つけます。
p
- 点
Component.contains(int, int)
,
getComponentAt(int, int)
public void addNotify()
Component
内の addNotify
Component.isDisplayable()
,
removeNotify()
public void removeNotify()
Component
内の removeNotify
Component.isDisplayable()
,
addNotify()
public boolean isAncestorOf(Component c)
c
- コンポーネント
true
、そうでない場合は false
protected String paramString()
Container
の状態を表す文字列を返します。このメソッドは、デバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空白の場合がありますが、null
にはなりません。
Component
内の paramString
public void list(PrintStream out, int indent)
コンテナの直接の子は indent+1
のインデント位置で出力されます。これらの子の子は indent+2
、以下同様に出力されます。
Component
内の list
out
- 出力ストリームindent
- インデントされるスペースの数Component.list(java.io.PrintStream, int)
public void list(PrintWriter out, int indent)
コンテナの直接の子は indent+1
のインデント位置で出力されます。これらの子の子は indent+2
、以下同様に出力されます。
Component
内の list
out
- プリントライターindent
- インデントされるスペースの数Component.list(java.io.PrintWriter, int)
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 つ下のフォーカストラバーサルサイクルに移動 | なし |
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_KEYSkeystrokes
- 指定された操作に対する 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 イベントを表していない場合、またはキーストロークのいずれかがこのコンテナの別のフォーカストラバーサル操作にマップされている場合getFocusTraversalKeys(int)
,
KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS
,
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS
,
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
,
KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
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
IllegalArgumentException
- id が次のどれでもない場合。KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS、または KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYSsetFocusTraversalKeys(int, java.util.Set extends java.awt.AWTKeyStroke>)
,
KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS
,
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS
,
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
,
KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
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_KEYSpublic boolean isFocusCycleRoot(Container container)
true
を返します。
Component
内の isFocusCycleRoot
container
- 判定対象の Container
true
、そうでない場合は false
isFocusCycleRoot()
public void transferFocusBackward()
Component
の記述:
Component
内の transferFocusBackward
Component.requestFocus()
public void setFocusTraversalPolicy(FocusTraversalPolicy policy)
このコンテナがフォーカスサイクルルートでない場合、ポリシーは記録されますが、このコンテナがフォーカスサイクルルートになるまでは、このコンテナが使用することも、他のコンテナによって継承されることもありません。
policy
- このコンテナの新しいフォーカストラバーサルポリシーgetFocusTraversalPolicy()
,
setFocusCycleRoot(boolean)
,
isFocusCycleRoot(java.awt.Container)
public FocusTraversalPolicy getFocusTraversalPolicy()
setFocusTraversalPolicy(java.awt.FocusTraversalPolicy)
,
setFocusCycleRoot(boolean)
,
isFocusCycleRoot(java.awt.Container)
public boolean isFocusTraversalPolicySet()
false
を返す場合、このコンテナは上位のコンテナからトラバーサルポリシーを継承します。
true
、そうでない場合は false
public void setFocusCycleRoot(boolean focusCycleRoot)
コンテナの子のトラバーサル順を指定する別の方法は、このコンテナを「フォーカストラバーサルポリシープロバイダ」にすることです。
focusCycleRoot
- このコンテナがフォーカストラバーサルサイクルのルートであることを示すisFocusCycleRoot()
,
setFocusTraversalPolicy(java.awt.FocusTraversalPolicy)
,
getFocusTraversalPolicy()
,
ContainerOrderFocusTraversalPolicy
,
setFocusTraversalPolicyProvider(boolean)
public boolean isFocusCycleRoot()
setFocusCycleRoot(boolean)
,
setFocusTraversalPolicy(java.awt.FocusTraversalPolicy)
,
getFocusTraversalPolicy()
,
ContainerOrderFocusTraversalPolicy
public final void setFocusTraversalPolicyProvider(boolean provider)
true
に設定したコンテナを使用して、最も近い上位フォーカスサイクルルートの代わりに、フォーカストラバーサルポリシーを取得します。
provide
- このコンテナを使用して、フォーカストラバーサルポリシーを提供するかどうかを指定するsetFocusTraversalPolicy(java.awt.FocusTraversalPolicy)
,
getFocusTraversalPolicy()
,
isFocusTraversalPolicyProvider()
public final boolean isFocusTraversalPolicyProvider()
true
に設定されている場合、キーボードフォーカスマネージャがコンテナ階層からフォーカストラバーサルポリシーを検索する際に、このプロパティが true の他のすべてのコンテナまたはフォーカスサイクルルートの前にこのコンテナを検出し、フォーカスサイクルルートのポリシーの代わりにそのフォーカストラバーサルポリシーを使用します。
true
、そうでない場合は false
setFocusTraversalPolicy(java.awt.FocusTraversalPolicy)
,
getFocusTraversalPolicy()
,
setFocusCycleRoot(boolean)
,
setFocusTraversalPolicyProvider(boolean)
public void transferFocusDownCycle()
Component.requestFocus()
,
isFocusCycleRoot(java.awt.Container)
,
setFocusCycleRoot(boolean)
public void applyComponentOrientation(ComponentOrientation o)
ComponentOrientation
プロパティを設定します。
Component
内の applyComponentOrientation
o
- このコンテナと含まれるすべてのコンポーネントの新しいコンポーネント方向
NullPointerException
- orientation
が null の場合Component.setComponentOrientation(java.awt.ComponentOrientation)
,
Component.getComponentOrientation()
public void addPropertyChangeListener(PropertyChangeListener listener)
listener が null の場合は、例外はスローされず、何も処理はありません。
Component
内の addPropertyChangeListener
listener
- 追加する PropertyChangeListenerComponent.removePropertyChangeListener(java.beans.PropertyChangeListener)
,
addPropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)
public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
listener が null の場合は、例外はスローされず、何も処理はありません。
Component
内の addPropertyChangeListener
propertyName
- 上記のプロパティ名のいずれかlistener
- 追加する PropertyChangeListeneraddPropertyChangeListener(java.beans.PropertyChangeListener)
,
Component.removePropertyChangeListener(java.beans.PropertyChangeListener)
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。