java.awt
クラス Window

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Window

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

Accessible, ImageObserver, MenuContainer, Serializable

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

BasicToolBarUI.DragWindow, Dialog, Frame, JWindow

public class Window

extends Container

implements Accessible

Window オブジェクトはボーダおよびメニューバーを持たないトップレベルウィンドウです。ウィンドウのデフォルトのレイアウトは BorderLayout です。

ウィンドウの作成時には、フレーム、ダイアログ、またはほかのウィンドウをそのオーナとして定義しなければなりません。

マルチスクリーン環境では、Window(Window, GraphicsConfiguration) で Window を構築して異なったスクリーンデバイス上に Window を作成できます。GraphicsConfiguration オブジェクトはターゲットスクリーンデバイスの GraphicsConfiguration オブジェクトの 1 つです。

デスクトップエリアが、物理的に複数のスクリーンデバイスにまたがる仮想デバイスマルチスクリーン環境では、すべての設定の境界は仮想デバイスの座標体系を基準にしています。仮想座標体系の原点は物理的なプライマリスクリーンの左上隅にあります。仮想デバイスのプライマリスクリーンの位置によっては、次の図に示すとおり負の座標も可能です。

そのような環境では、setLocation を呼び出すにはこのメソッドに仮想座標を渡す必要があります。同様に、Window 上で getLocationOnScreen を呼び出すと、仮想デバイス座標を返します。仮想座標体系の原点を検索するには、GraphicsConfiguration の getBounds メソッドを呼び出します。

次のコードは、Window の位置を対応する GraphicsConfiguration の物理的スクリーンの原点を基準にして (10、10) に設定します。GraphicsConfiguration の境界が考慮されない場合は、Window の位置は仮想座標体系を基準に (10、10) に設定され、指定された GraphicsConfiguration の物理的スクリーンとは異なり、物理的なプライマリスクリーンに表示されます。

	Window w = new Window(Window owner, GraphicsConfiguration gc);
	Rectangle bounds = gc.getBounds();
	w.setLocation(10 + bounds.x, 10 + bounds.y);

ウィンドウは、WindowEvents、WindowOpened、WindowClosed、WindowGainedFocus および WindowLostFocus を生成することができます。

導入されたバージョン:

JDK1.0

関連項目:

WindowEvent, addWindowListener(java.awt.event.WindowListener), BorderLayout, 直列化された形式

入れ子クラスの概要

protected class

Window.AccessibleAWTWindow このクラスは Window クラス用のユーザ補助機能のサポートを実装しています。

クラス java.awt.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

コンストラクタの概要

Window(Frame owner)
オーナとして指定された Frame を持つ新しい不可視のウィンドウを構築します。

Window(Window owner)
オーナとして指定された Window を持つ新しい不可視のウィンドウを構築します。

Window(Window owner, GraphicsConfiguration gc)
オーナとして指定されたウィンドウを持つ新しい不可視のウィンドウおよびスクリーンデバイスの GraphicsConfiguration を構築します。

メソッドの概要

void	addNotify() ネイティブスクリーンリソースへの接続を作成して、この Window を表示可能にします。
void	addPropertyChangeListener(PropertyChangeListener listener) PropertyChangeListener をリスナーリストに追加します。
void	addPropertyChangeListener(String propertyName, PropertyChangeListener listener) 特定のプロパティのリスナーリストに PropertyChangeListener を追加します。
void	addWindowFocusListener(WindowFocusListener l) このウィンドウからウィンドウフォーカスリスナーを受け取るために、指定されたウィンドウリスナーを追加します。
void	addWindowListener(WindowListener l) このウィンドウからウィンドウイベントを受け取るために、指定されたウィンドウリスナーを追加します。
void	addWindowStateListener(WindowStateListener l) このウィンドウからウィンドウイベントを受け取るために、指定されたウィンドウ状態リスナーを追加します。
void	applyResourceBundle(ResourceBundle rb) 推奨されていません。 J2SE バージョン 1.4 以降は、Component.applyComponentOrientation を使用
void	applyResourceBundle(String rbName) 推奨されていません。 J2SE バージョン 1.4 以降は、Component.applyComponentOrientation を使用
void	createBufferStrategy(int numBuffers) このコンポーネントの新しいマルチバッファリング方法を作成します。
void	createBufferStrategy(int numBuffers, BufferCapabilities caps) 必要なバッファ機能を持つこのコンポーネントのマルチバッファリングの新しい方式を作成します。
void	dispose() この Window、そのサブコンポーネントと、その所有されたすべての子によって使用されているすべてのネイティブスクリーンリソースを解放します。
protected void	finalize() インプットメソッドおよびコンテキストを破棄し、この Window を指していた WeakReference を親の所有 Window リストから削除します。
AccessibleContext	getAccessibleContext() この Window に関連した AccessibleContext を返します。
BufferStrategy	getBufferStrategy()
boolean	getFocusableWindowState() isFocusableWindow に概説されたその他の要件に合致する場合に、この Window がフォーカスされた Window になれるかどうかを返します。
Container	getFocusCycleRootAncestor() Window が上位 Window を持たないため、常に null を返します。
Component	getFocusOwner() この Window がフォーカスされている場合は、この Window の子 Component を返します。
Set	getFocusTraversalKeys(int id) この Window のフォーカストラバーサルキーを返します (各キーの詳細については、 setFocusTraversalKey を参照)。
GraphicsConfiguration	getGraphicsConfiguration() このメソッドは、この Window が使用する GraphicsConfiguration を返します。
InputContext	getInputContext() このウィンドウの入力コンテキストを返します。
EventListener[]	getListeners(Class listenerType) この Window に FooListener として、現在登録されているすべてのオブジェクトの配列を返します。
Locale	getLocale() ロケールが設定されている場合に、このウィンドウに関連している Locale オブジェクトを返します。
Component	getMostRecentFocusOwner() この Window がフォーカスされるときに、フォーカスを受け取るこの Window の子 Component を返します。
Window[]	getOwnedWindows() 現在このウィンドウが所有しているすべてのウィンドウが格納されている配列を返します。
Window	getOwner() このウィンドウのオーナを返します。
Toolkit	getToolkit() このフレームのツールキットを返します。
String	getWarningString() このウィンドウで表示される警告文字列を返します。
WindowFocusListener[]	getWindowFocusListeners() このウィンドウに登録されたすべてのウィンドウフォーカスリスナーの配列を返します。
WindowListener[]	getWindowListeners() このウィンドウに登録されたすべてのウィンドウリスナーの配列を返します。
WindowStateListener[]	getWindowStateListeners() このウィンドウに登録されたすべてのウィンドウ状態リスナーの配列を返します。
void	hide() この Window、そのサブコンポーネント、その所有されたすべての子を隠します。
boolean	isActive() この Window がアクティブであるかどうかを返します。
boolean	isFocusableWindow() この Window がフォーカスされた Window になれるかどうか、つまりこの Window またはその任意のサブコンポーネントがフォーカスオーナになれるかどうかを返します。
boolean	isFocusCycleRoot() すべての Window はフォーカストラバーサルサイクルのルートでなければならないため、常に true を返します。
boolean	isFocused() この Window がフォーカスされているかどうかを返します。
boolean	isShowing() この Window が画面に表示されているかどうか判定します。
void	pack() サブコンポーネントの推奨サイズおよびレイアウトに合わせて、この Window をサイズ変更します。
boolean	postEvent(Event e) 推奨されていません。 JDK バージョン 1.1 以降は、dispatchEvent(AWTEvent) を使用
protected void	processEvent(AWTEvent e) このウィンドウのイベントを処理します。
protected void	processWindowEvent(WindowEvent e) 登録された任意の WindowListener オブジェクトにディスパッチすることにより、このウィンドウで発生するウィンドウイベントを処理します。
protected void	processWindowFocusEvent(WindowEvent e) 登録された任意の WindowFocusListener オブジェクトにディスパッチすることにより、このウィンドウで発生するウィンドウフォーカスイベントを処理します。
protected void	processWindowStateEvent(WindowEvent e) 登録された任意の WindowStateListener オブジェクトにディスパッチすることにより、このウィンドウで発生するウィンドウ状態イベントを処理します。
void	removeWindowFocusListener(WindowFocusListener l) このウィンドウからウィンドウイベントを受け取らないように、指定されたウィンドウフォーカスリスナーを削除します。
void	removeWindowListener(WindowListener l) このウィンドウからウィンドウイベントを受け取らないように、指定されたウィンドウリスナーを削除します。
void	removeWindowStateListener(WindowStateListener l) このウィンドウからウィンドウイベントを受け取らないように、指定されたウィンドウ状態リスナーを削除します。
void	setCursor(Cursor cursor) 指定されたカーソルにそのイメージを設定します。
void	setFocusableWindowState(boolean focusableWindowState) isFocusableWindow に概説されたその他の要件に合致する場合に、この Window がフォーカスされた Window になれるかどうかを設定します。
void	setFocusCycleRoot(boolean focusCycleRoot) Window は常にフォーカストラバーサルサイクルのルートであるため、何も操作は行われません。
void	setLocationRelativeTo(Component c) 指定されたコンポーネントを基準にしてウィンドウの位置を設定します。
void	show() Window を表示します。
void	toBack() この Window が可視の場合、この Window を背後に送り、フォーカスされているかまたはアクティブ Window の場合はフォーカスまたはアクティベーションを消失するようにします。
void	toFront() この Window が可視の場合、この Window を前面に移動してフォーカスされた Window にできるようにします。

クラス java.awt.Container から継承したメソッド

add, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setFocusTraversalKeys, setFocusTraversalPolicy, setFont, setLayout, transferFocusBackward, transferFocusDownCycle, update, validate, 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, getBackground, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isOpaque, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, 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, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, size, toString, transferFocus, transferFocusUpCycle

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

clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

Window

public Window(Frame owner)

オーナとして指定された Frame を持つ新しい不可視のウィンドウを構築します。Window は、そのオーナが画面に表示されないかぎりフォーカス可能になりません。

セキュリティマネージャが存在する場合、このメソッドは最初にセキュリティマネージャの checkTopLevelWindow メソッドを引数 this で呼び出して、ウィンドウを表示するときに警告バナーも表示する必要があるかどうかを判断します。

パラメータ:

owner - オーナとなる Frame

例外:

IllegalArgumentException - owner の GraphicsConfiguration がスクリーンデバイスによらない場合

IllegalArgumentException - owner が null の場合。この例外は GraphicsEnvironment.isHeadless が true を返す場合、常にスローされる

関連項目:

GraphicsEnvironment.isHeadless(), SecurityManager.checkTopLevelWindow(java.lang.Object), isShowing()

Window

public Window(Window owner)

オーナとして指定された Window を持つ新しい不可視のウィンドウを構築します。Window は、もっとも近くに所有する Frame または Dialog が画面に表示されないかぎりフォーカス可能になりません。

セキュリティマネージャが存在する場合、このメソッドは最初にセキュリティマネージャの checkTopLevelWindow メソッドを引数 this で呼び出して、ウィンドウを表示するときに警告バナーも表示する必要があるかどうかを判断します。

パラメータ:

owner - オーナとなる Window

例外:

IllegalArgumentException - owner の GraphicsConfiguration がスクリーンデバイスによらない場合

IllegalArgumentException - owner が null の場合。この例外は GraphicsEnvironment.isHeadless() が true を返す場合、常にスローされる

導入されたバージョン:

1.2

関連項目:

GraphicsEnvironment.isHeadless(), SecurityManager.checkTopLevelWindow(java.lang.Object), isShowing()

Window

public Window(Window owner,
              GraphicsConfiguration gc)

オーナとして指定されたウィンドウを持つ新しい不可視のウィンドウおよびスクリーンデバイスの GraphicsConfiguration を構築します。Window は、もっとも近くに所有する Frame または Dialog が画面に表示されないかぎりフォーカス可能になりません。

セキュリティマネージャが存在する場合、このメソッドは最初にセキュリティマネージャの checkTopLevelWindow メソッドを引数 this で呼び出して、ウィンドウを表示するときに警告バナーも表示する必要があるかどうかを判断します。

パラメータ:

owner - オーナとなるウィンドウ

gc - ターゲットスクリーンデバイスの GraphicsConfiguration。gc が null の場合は、GraphicsConfiguration をデフォルトと見なす

例外:

IllegalArgumentException - owner が null の場合

IllegalArgumentException - gc がスクリーンデバイスによらない場合。この例外は GraphicsEnvironment.isHeadless が true を返す場合、常にスローされる

導入されたバージョン:

1.3

関連項目:

GraphicsEnvironment.isHeadless(), SecurityManager.checkTopLevelWindow(java.lang.Object), GraphicsConfiguration.getBounds(), isShowing()

メソッドの詳細

finalize

protected void finalize()
                 throws Throwable

インプットメソッドおよびコンテキストを破棄し、この Window を指していた WeakReference を親の所有 Window リストから削除します。

オーバーライド:

クラス Object 内の finalize

例外:

Throwable - このメソッドで生じた Exception

addNotify

public void addNotify()

ネイティブスクリーンリソースへの接続を作成して、この Window を表示可能にします。このメソッドは、ツールキットによって内部で呼び出されます。プログラムが直接呼び出すことはできません。

オーバーライド:

クラス Container 内の addNotify

導入されたバージョン:

JDK1.0

関連項目:

Component.isDisplayable(), Container.removeNotify()

pack

public void pack()

サブコンポーネントの推奨サイズおよびレイアウトに合わせて、この Window をサイズ変更します。ウィンドウおよびそのオーナがまだ表示可能でない場合は、両方とも表示可能にしてから推奨サイズを計算します。preferredSize が計算されたあとに、Window は検査を受けます。

関連項目:

Component.isDisplayable()

show

public void show()

Window を表示します。Window およびそのオーナがまだ表示可能でない場合は、両方とも表示可能にします。Window は、表示される前に検査を受けます。Window がすでに表示されている場合、このメソッドは Window を前面に表示します。

オーバーライド:

クラス Component 内の show

関連項目:

Component.isDisplayable(), toFront(), Component.setVisible(boolean)

hide

public void hide()

この Window、そのサブコンポーネント、その所有されたすべての子を隠します。Window とそのサブコンポーネントは show を呼び出して、再度可視状態にできます。

オーバーライド:

クラス Component 内の hide

関連項目:

show(), dispose()

dispose

public void dispose()

この Window、そのサブコンポーネントと、その所有されたすべての子によって使用されているすべてのネイティブスクリーンリソースを解放します。つまり、これらの Component のリソースが破棄され、それらの消費するメモリが OS に戻ります。Window、そのサブコンポーネントと、その所有されたすべての子は、表示不可能としてマークされます。

Window およびそのサブコンポーネントは、pack または show を呼び出してネイティブリソースを再構築すれば再び表示可能にできます。再生された Window およびそのサブコンポーネントの状態は、Window が破棄された時点のそれらのオブジェクトの状態と同じです。破棄と再生の間の追加変更は考慮されません。

関連項目:

Component.isDisplayable(), pack(), show()

toFront

public void toFront()

この Window が可視の場合、この Window を前面に移動してフォーカスされた Window にできるようにします。

この Window をスタックの最上位に置き、この VM のほかのすべての Window の前に表示します。この Window が可視でない場合、処理は何も行われません。一部のプラットフォームでは、ほかの Window を持つ Window をこのような所有された Window の一番上に表示することはできません。一部のプラットフォームでは、この VM をネイティブアプリケーションのウィンドウ、またはほかの VM の Window の上に置くことを許可していません。このアクセス権はこの VM の Window がフォーカス済みであるかどうかに依存します。この Window をスタックされる順のできるだけ上位に移動するあらゆる試行が行われます。ただし、開発者は、このメソッドがどんな状況でもこの Window をほかのすべてのウィンドウの上に移動すると見なしてはなりません。

ネイティブなウィンドウ処理システムのバリエーションのため、フォーカスされたアクティブな Window に対して行われた変更は保証されません。開発者は、この Window が WINDOW_GAINED_FOCUS または WINDOW_ACTIVATED イベントを受け取るまで、この Window がフォーカスされているか、またはアクティブな Window であると決して見なしてはなりません。最上位のウィンドウがフォーカスされたウィンドウであるプラットフォームでは、まだフォーカスされていない場合は、このメソッドはおそらく この Window をフォーカスします。スタックされる順が、通常フォーカスされたウィンドウに影響しないプラットフォームでは、このメソッドは、フォーカスされたアクティブな Window をおそらく変更されないままにします。

このメソッドがこの Window をフォーカスされた状態にし、この Window が Frame または Dialog の場合、この Window もアクティブになります。この Window がフォーカスされているが Frame または Dialog でない場合、この Window の最初の Frame または Dialog がアクティブになります。

関連項目:

toBack()

toBack

public void toBack()

この Window が可視の場合、この Window を背後に送り、フォーカスされているかまたはアクティブ Window の場合はフォーカスまたはアクティベーションを消失するようにします。

この Window をスタックされる順の最下位に置き、この VM のほかのすべての Window の背後に表示します。この Window が可視でない場合、処理は何も行われません。一部のプラットフォームでは、ほかの Window に所有されている Window をオーナの下に表示することはできません。この Window をスタックされる順のできるだけ下位に移動するためにあらゆる試行が行われます。ただし、開発者はこのメソッドがどんな状況でもこの Window をほかのすべてのウィンドウの下に移動させると見なしてはなりません。

ネイティブなウィンドウ処理システムのバリエーションのため、フォーカスされたアクティブな Window に対して行われた変更は保証されません。開発者は、この Window が WINDOW_LOST_FOCUS または WINDOW_DEACTIVATED イベントを受け取るまで、この Window がフォーカスされていないか、またはアクティブな Window ではないと決して見なしてはなりません。最上位のウィンドウがフォーカスされたウィンドウであるプラットフォームでは、このメソッドはおそらく この Window のフォーカスを消失させます。このような場合、この VM の次に上位にあるフォーカス可能な Window がフォーカスを受け取ります。スタックされる順が、通常フォーカスされたウィンドウに影響しないプラットフォームでは、このメソッドは、フォーカスされたアクティブな Window をおそらく変更されないままにします。

関連項目:

toFront()

getToolkit

public Toolkit getToolkit()

このフレームのツールキットを返します。

オーバーライド:

クラス Component 内の getToolkit

戻り値:

このウィンドウのツールキット

関連項目:

Toolkit, Toolkit.getDefaultToolkit(), Component.getToolkit()

getWarningString

public final String getWarningString()

このウィンドウで表示される警告文字列を返します。このウィンドウがセキュリティ保護されていない場合、ウィンドウの可視領域のどこかに警告文字列が表示されます。セキュリティマネージャが存在し、セキュリティマネージャの checkTopLevelWindow メソッドでこのウィンドウを引数として渡したときに false が返される場合はセキュリティ保護されていません。

ウィンドウがセキュリティ保護されている場合、getWarningString は null を返します。ウィンドウがセキュリティ保護されていない場合、このメソッドはシステムプロパティの awt.appletWarning を検査し、そのプロパティの文字列の値を返します。

戻り値:

このウィンドウの警告文字列

関連項目:

SecurityManager.checkTopLevelWindow(java.lang.Object)

getLocale

public Locale getLocale()

ロケールが設定されている場合に、このウィンドウに関連している Locale オブジェクトを返します。ロケールが設定されていない場合は、デフォルトのロケールが返されます。

オーバーライド:

クラス Component 内の getLocale

戻り値:

このウィンドウに設定されているロケール

導入されたバージョン:

JDK1.1

関連項目:

Locale

getInputContext

public InputContext getInputContext()

このウィンドウの入力コンテキストを返します。ウィンドウは必ず入力コンテキストを持ちます。この入力コンテキストは、サブコンポーネントが自身の入力コンテキストを作成および設定しない限り、サブコンポーネントによって共有されます。

オーバーライド:

クラス Component 内の getInputContext

戻り値:

このコンポーネントが使用する入力コンテキスト。コンテキストを判別できない場合は null

導入されたバージョン:

1.2

関連項目:

Component.getInputContext()

setCursor

public void setCursor(Cursor cursor)

指定されたカーソルにそのイメージを設定します。

オーバーライド:

クラス Component 内の setCursor

パラメータ:

cursor - Cursor クラスで定義されている定数の 1 つ。このパラメータが null の場合、このコンポーネントは親のカーソルを継承する

導入されたバージョン:

JDK1.1

関連項目:

Component.getCursor(), Cursor

getOwner

public Window getOwner()

このウィンドウのオーナを返します。

getOwnedWindows

public Window[] getOwnedWindows()

現在このウィンドウが所有しているすべてのウィンドウが格納されている配列を返します。

導入されたバージョン:

1.2

addWindowListener

public void addWindowListener(WindowListener l)

このウィンドウからウィンドウイベントを受け取るために、指定されたウィンドウリスナーを追加します。l が null の場合、例外はスローされず、処理も実行されません。

パラメータ:

l - ウィンドウリスナー

関連項目:

removeWindowListener(java.awt.event.WindowListener), getWindowListeners()

addWindowStateListener

public void addWindowStateListener(WindowStateListener l)

このウィンドウからウィンドウイベントを受け取るために、指定されたウィンドウ状態リスナーを追加します。l が null の場合、例外はスローされず、処理も実行されません。

パラメータ:

l - ウィンドウ状態リスナー

導入されたバージョン:

1.4

関連項目:

removeWindowStateListener(java.awt.event.WindowStateListener), getWindowStateListeners()

addWindowFocusListener

public void addWindowFocusListener(WindowFocusListener l)

このウィンドウからウィンドウフォーカスリスナーを受け取るために、指定されたウィンドウリスナーを追加します。l が null の場合、例外はスローされず、処理も実行されません。

パラメータ:

l - ウィンドウフォーカスリスナー

関連項目:

removeWindowFocusListener(java.awt.event.WindowFocusListener), getWindowFocusListeners()

removeWindowListener

public void removeWindowListener(WindowListener l)

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

パラメータ:

l - ウィンドウリスナー

関連項目:

addWindowListener(java.awt.event.WindowListener), getWindowListeners()

removeWindowStateListener

public void removeWindowStateListener(WindowStateListener l)

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

パラメータ:

l - ウィンドウ状態リスナー

導入されたバージョン:

1.4

関連項目:

addWindowStateListener(java.awt.event.WindowStateListener), getWindowStateListeners()

removeWindowFocusListener

public void removeWindowFocusListener(WindowFocusListener l)

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

パラメータ:

l - ウィンドウフォーカスリスナー

関連項目:

addWindowFocusListener(java.awt.event.WindowFocusListener), getWindowFocusListeners()

getWindowListeners

public WindowListener[] getWindowListeners()

このウィンドウに登録されたすべてのウィンドウリスナーの配列を返します。

戻り値:

このウィンドウのすべての WindowListener、または現在ウィンドウリスナーが登録されていない場合は空の配列

導入されたバージョン:

1.4

関連項目:

addWindowListener(java.awt.event.WindowListener), removeWindowListener(java.awt.event.WindowListener)

getWindowFocusListeners

public WindowFocusListener[] getWindowFocusListeners()

このウィンドウに登録されたすべてのウィンドウフォーカスリスナーの配列を返します。

戻り値:

このウィンドウのすべての WindowFocusListener、または現在ウィンドウフォーカスリスナーが登録されていない場合は空の配列

導入されたバージョン:

1.4

関連項目:

addWindowFocusListener(java.awt.event.WindowFocusListener), removeWindowFocusListener(java.awt.event.WindowFocusListener)

getWindowStateListeners

public WindowStateListener[] getWindowStateListeners()

このウィンドウに登録されたすべてのウィンドウ状態リスナーの配列を返します。

戻り値:

このウィンドウのすべての WindowStateListener、または現在ウィンドウ状態リスナーが登録されていない場合は空の配列

導入されたバージョン:

1.4

関連項目:

addWindowStateListener(java.awt.event.WindowStateListener), removeWindowStateListener(java.awt.event.WindowStateListener)

getListeners

public EventListener[] getListeners(Class listenerType)

この Window に FooListener として、現在登録されているすべてのオブジェクトの配列を返します。FooListener は addFooListener メソッドを使用して登録されます。

FooListener.class などのクラスリテラルを持つ listenerType 引数を指定できます。たとえば、次のコードを使用して、そのテキストリスナーの Window w を照会できます。

WindowListener[] wls = (WindowListener[])(w.getListeners(WindowListener.class));

このようなリスナーが存在しない場合、このメソッドは空の配列を返します。

オーバーライド:

クラス Container 内の getListeners

パラメータ:

listenerType - 要求されたリスナーの型。このパラメータは java.util.EventListener から派生するインタフェースを指定する

戻り値:

このウィンドウの FooListener として登録されたすべてのオブジェクトの配列、またはこのようなリスナーが追加されなかった場合は空の配列

例外:

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

導入されたバージョン:

1.3

関連項目:

getWindowListeners()

processEvent

protected void processEvent(AWTEvent e)

このウィンドウのイベントを処理します。イベントが WindowEvent の場合、processWindowEvent メソッドを起動します。その他の場合は、スーパークラスの processEvent を起動します。

イベントパラメータが null の場合、動作が指定されず例外が発生することに注意してください。

オーバーライド:

クラス Container 内の processEvent

パラメータ:

e - イベント

processWindowEvent

protected void processWindowEvent(WindowEvent e)

登録された任意の WindowListener オブジェクトにディスパッチすることにより、このウィンドウで発生するウィンドウイベントを処理します。注: ウィンドウイベントがこのコンポーネントで使用可能でない場合、このメソッドは呼び出されません。これは次のいずれか 1 つが発生した場合に実行されます。

• WindowListener オブジェクトが addWindowListener によって登録される
• enableEvents によってウィンドウイベントが使用可能になっている

イベントパラメータが null の場合、動作が指定されず例外が発生することに注意してください。

パラメータ:

e - ウィンドウイベント

関連項目:

Component.enableEvents(long)

processWindowFocusEvent

protected void processWindowFocusEvent(WindowEvent e)

登録された任意の WindowFocusListener オブジェクトにディスパッチすることにより、このウィンドウで発生するウィンドウフォーカスイベントを処理します。注: ウィンドウフォーカスイベントがこのウィンドウで使用可能でない場合、このメソッドは呼び出されません。これは次のいずれか 1 つが発生した場合に実行されます。

• WindowFocusListener が addWindowFocusListener によって登録される
• enableEvents によってウィンドウフォーカスイベントが使用可能になっている

イベントパラメータが null の場合、動作が指定されず例外が発生することに注意してください。

パラメータ:

e - ウインドウフォーカスイベント

関連項目:

Component.enableEvents(long)

processWindowStateEvent

protected void processWindowStateEvent(WindowEvent e)

登録された任意の WindowStateListener オブジェクトにディスパッチすることにより、このウィンドウで発生するウィンドウ状態イベントを処理します。注: ウィンドウ状態イベントがこのウィンドウで使用可能でない場合、このメソッドは呼び出されません。これは次のいずれか 1 つが発生した場合に実行されます。

• WindowStateListener が addWindowStateListener によって登録される
• enableEvents によってウィンドウ状態イベントが使用可能になっている

イベントパラメータが null の場合、動作が指定されず例外が発生することに注意してください。

パラメータ:

e - ウィンドウ状態イベント

導入されたバージョン:

1.4

関連項目:

Component.enableEvents(long)

getFocusOwner

public Component getFocusOwner()

この Window がフォーカスされている場合は、この Window の子 Component を返します。そうでない場合は null を返します。

戻り値:

フォーカスを持つ子 Component、またはこの Window がフォーカスされていない場合は null

関連項目:

getMostRecentFocusOwner(), isFocused()

getMostRecentFocusOwner

public Component getMostRecentFocusOwner()

この Window がフォーカスされるときに、フォーカスを受け取るこの Window の子 Component を返します。この Window が現在フォーカスされている場合、このメソッドは getFocusOwner() と同じ Component を返します。この Window がフォーカスされていない場合、直前にフォーカスを要求した子 Component が返されます。子 Component がフォーカスを要求しなかった場合でこれがフォーカス可能 Window の場合、Window のフォーカス可能な初期 Component が返されます。子 Component がフォーカスを要求しなかった場合でこれがフォーカス可能な Window ではない場合、null が返されます。

戻り値:

この Window がフォーカスされるときにフォーカスを受け取る子 Component

導入されたバージョン:

1.4

関連項目:

getFocusOwner(), isFocused(), isFocusableWindow()

isActive

public boolean isActive()

この Window がアクティブであるかどうかを返します。Frame または Dialog のみがアクティブ になります。ネイティブのウィンドウ処理システムは、アクティブ Window またはハイライトされたタイトルバーなど特別な装飾を持つその子を表します。アクティブ Window は、常に、フォーカスされた Window か、またはフォーカスされた Window のオーナである最初の Frame または Dialog のいずれかです。

戻り値:

これがアクティブ Window であるかどうか

導入されたバージョン:

1.4

関連項目:

isFocused()

isFocused

public boolean isFocused()

この Window がフォーカスされているかどうかを返します。フォーカスオーナが存在する場合、フォーカスされた Window はフォーカスオーナであるか、またはフォーカスオーナを含みます。フォーカスオーナが存在しない場合、Window はフォーカスされません。

フォーカスされた Window が Frame または Dialog の場合、これもアクティブ Window です。そうでない場合、アクティブ Window はフォーカスされた Window のオーナである最初の Frame または Dialog です。

戻り値:

これがフォーカスされた Window であるかどうか

導入されたバージョン:

1.4

関連項目:

isActive()

getFocusTraversalKeys

public Set getFocusTraversalKeys(int id)

この Window のフォーカストラバーサルキーを返します (各キーの詳細については、 setFocusTraversalKey を参照)。

この Window に対して、トラバーサルキーが明示的に設定されていない場合、この Window の親のトラバーサルキーが返されます。この Window の任意の上位 Window に対して、トラバーサルキーが明示的に設定されていない場合、現在の KeyboardFocusManager のデフォルトのトラバーサルキーが返されます。

オーバーライド:

クラス Container 内の getFocusTraversalKeys

パラメータ:

id - 次のいずれか 1 つ。KeyboardFocusManager.FORWARD_TRAVERSAL_KEY、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEY、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEY、または KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEY

戻り値:

指定されたキーの AWTKeyStroke

例外:

IllegalArgumentException - id が次のいずれか 1 つでない場合。KeyboardFocusManager.FORWARD_TRAVERSAL_KEY、KeyboardFocusManager.BACKWARD_TRAVERSAL_KEY、KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEY、または KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEY

導入されたバージョン:

1.4

関連項目:

#setFocusTraversalKey, KeyboardFocusManager#FORWARD_TRAVERSAL_KEY, KeyboardFocusManager#BACKWARD_TRAVERSAL_KEY, KeyboardFocusManager#UP_CYCLE_TRAVERSAL_KEY, KeyboardFocusManager#DOWN_CYCLE_TRAVERSAL_KEY

setFocusCycleRoot

public final void setFocusCycleRoot(boolean focusCycleRoot)

Window は常にフォーカストラバーサルサイクルのルートであるため、何も操作は行われません。渡された値は無視されます。

オーバーライド:

クラス Container 内の setFocusCycleRoot

パラメータ:

focusCycleRoot - この値は無視される

導入されたバージョン:

1.4

関連項目:

isFocusCycleRoot(), Container.setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), Container.getFocusTraversalPolicy()

isFocusCycleRoot

public final boolean isFocusCycleRoot()

すべての Window はフォーカストラバーサルサイクルのルートでなければならないため、常に true を返します。

オーバーライド:

クラス Container 内の isFocusCycleRoot

戻り値:

true

導入されたバージョン:

1.4

関連項目:

setFocusCycleRoot(boolean), Container.setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), Container.getFocusTraversalPolicy()

getFocusCycleRootAncestor

public final Container getFocusCycleRootAncestor()

Window が上位 Window を持たないため、常に null を返します。これは Component の階層の最上位を示します。

オーバーライド:

クラス Component 内の getFocusCycleRootAncestor

戻り値:

null

導入されたバージョン:

1.4

関連項目:

Container.isFocusCycleRoot()

isFocusableWindow

public final boolean isFocusableWindow()

この Window がフォーカスされた Window になれるかどうか、つまりこの Window またはその任意のサブコンポーネントがフォーカスオーナになれるかどうかを返します。Frame または Dialog がフォーカス可能の場合、フォーカス可能な Window 状態は true に設定されなければなりません。Frame または Dialog がフォーカス可能ではない Window の場合、そのフォーカス可能な Window 状態は true に設定されなければならず、そのもっとも近くに所有する Frame または Dialog は画面に表示されなければならず、そのフォーカストラバーサルサイクルに少なくとも 1 つの Component が含まれていなければなりません。これらの条件の 1 つが合致しない場合、この Window またはその任意のサブコンポーネントはいずれもフォーカスオーナになることはできません。

戻り値:

この Window がフォーカされた Window になることができる場合は true、そうでない場合は false

導入されたバージョン:

1.4

関連項目:

getFocusableWindowState(), setFocusableWindowState(boolean), isShowing(), Component.isFocusable()

getFocusableWindowState

public boolean getFocusableWindowState()

isFocusableWindow に概説されたその他の要件に合致する場合に、この Window がフォーカスされた Window になれるかどうかを返します。このメソッドが false を返す場合、isFocusableWindow は同様に false を返します。このメソッドが true を返す場合、isFocusableWindow は Window がフォーカス可能となるために合致する必要のあるその他の要件によって、true または false を返します。

デフォルトで、すべての Window は true のフォーカス可能 Window 状態を持っています。

戻り値:

この Window がフォーカスされた Window になれるかどうか

導入されたバージョン:

1.4

関連項目:

isFocusableWindow(), setFocusableWindowState(boolean), isShowing(), Component.setFocusable(boolean)

setFocusableWindowState

public void setFocusableWindowState(boolean focusableWindowState)

isFocusableWindow に概説されたその他の要件に合致する場合に、この Window がフォーカスされた Window になれるかどうかを設定します。この Window フォーカス可能 Window 状態が false に設定される場合、isFocusableWindow は false を返します。この Window のフォーカス可能 Window 状態が true に設定される場合、isFocusableWindow は Window がフォーカス可能となるために合致する必要のあるその他の要件によって、true または false を返します。

Window のフォーカス可能性の状態を false に設定することは、Window がドラッグ可能なパレットやツールバーとして使用され、したがってフォーカス不可能な Window となることを アプリケーションが識別する AWT の標準の機構です。

パラメータ:

focusableWindowState - この Window がフォーカスされた Window になれるかどうか

導入されたバージョン:

1.4

関連項目:

isFocusableWindow(), getFocusableWindowState(), isShowing(), Component.setFocusable(boolean)

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

PropertyChangeListener をリスナーリストに追加します。このリスナーは、次のようなクラスのすべてのバウンドプロパティに登録されます。

• この Window のフォント ("font")
• この Window のバックグラウンドカラー ("background")
• この Window のフォアグラウンドカラー ("foreground")
• この Window フォーカス可能性 ("focusable")
• この Window のフォーカストラバーサルキーの使用可能状態 ("focusTraversalKeysEnabled")
• この Window の FORWARD_TRAVERSAL_KEYS の Set ("forwardFocusTraversalKeys")
• この Window の BACKWARD_TRAVERSAL_KEYS の Set ("backwardFocusTraversalKeys")
• この Window の UP_CYCLE_TRAVERSAL_KEYS の Set ("upCycleFocusTraversalKeys")
• この Window の DOWN_CYCLE_TRAVERSAL_KEYS の Set ("downCycleFocusTraversalKeys")
• この Window のフォーカストラバーサルポリシー ("focusTraversalPolicy")
• この Window のフォーカス可能な Window 状態 ("focusableWindowState")

この Window がバウンドプロパティを継承している場合、イベントは継承されたプロパティ内の変更に応答してトリガされないことに注意してください。

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

オーバーライド:

クラス Container 内の addPropertyChangeListener

パラメータ:

listener - 追加する PropertyChangeListener

関連項目:

Component.removePropertyChangeListener(java.beans.PropertyChangeListener), addPropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)

addPropertyChangeListener

public void addPropertyChangeListener(String propertyName,
                                      PropertyChangeListener listener)

特定のプロパティのリスナーリストに PropertyChangeListener を追加します。指定されたプロパティはユーザ定義の場合か、または次のいずれかです。

• この Window のフォント ("font")
• この Window のバックグラウンドカラー ("background")
• この Window のフォアグラウンドカラー ("foreground")
• この Window フォーカス可能性 ("focusable")
• この Window のフォーカストラバーサルキーの使用可能状態 ("focusTraversalKeysEnabled")
• この Window の FORWARD_TRAVERSAL_KEYS の Set ("forwardFocusTraversalKeys")
• この Window の BACKWARD_TRAVERSAL_KEYS の Set ("backwardFocusTraversalKeys")
• この Window の UP_CYCLE_TRAVERSAL_KEYS の Set ("upCycleFocusTraversalKeys")
• この Window の DOWN_CYCLE_TRAVERSAL_KEYS の Set ("downCycleFocusTraversalKeys")
• この Window のフォーカストラバーサルポリシー ("focusTraversalPolicy")
• この Window のフォーカス可能な Window 状態 ("focusableWindowState")

この Window がバウンドプロパティを継承している場合、イベントは継承されたプロパティ内の変更に応答してトリガされないことに注意してください。

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

オーバーライド:

クラス Container 内の addPropertyChangeListener

パラメータ:

propertyName - 上記のプロパティ名のどれか

listener - 追加する PropertyChangeListener

関連項目:

addPropertyChangeListener(java.beans.PropertyChangeListener), Component.removePropertyChangeListener(java.beans.PropertyChangeListener)

postEvent

public boolean postEvent(Event e)

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

定義:

インタフェース MenuContainer 内の postEvent

オーバーライド:

クラス Component 内の postEvent

isShowing

public boolean isShowing()

この Window が画面に表示されているかどうか判定します。

オーバーライド:

クラス Component 内の isShowing

戻り値:

コンポーネントが表示されている場合は true、そうでない場合は false

関連項目:

Component.setVisible(boolean)

applyResourceBundle

public void applyResourceBundle(ResourceBundle rb)

推奨されていません。 J2SE バージョン 1.4 以降は、Component.applyComponentOrientation を使用

ResourceBundle の ComponentOrientation をこの Window およびその中に含まれるすべてのコンポーネントに適用します。

導入されたバージョン:

1.2

関連項目:

ComponentOrientation

applyResourceBundle

public void applyResourceBundle(String rbName)

推奨されていません。 J2SE バージョン 1.4 以降は、Component.applyComponentOrientation を使用

デフォルトのロケールを使って指定された名前を持つ ResourceBundle をロードし、その ComponentOrientation をこの Window およびその中に含まれるすべてのコンポーネントに適用します。

導入されたバージョン:

1.2

関連項目:

ComponentOrientation

getAccessibleContext

public AccessibleContext getAccessibleContext()

この Window に関連した AccessibleContext を返します。ウィンドウの場合、AccessibleContext は AccessibleAWTWindow の形式を取ります。必要に応じて新規の AccessibleAWTWindow インスタンスが作成されます。

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス Component 内の getAccessibleContext

戻り値:

この Window の AccessibleContext として機能する AccessibleAWTWindow

getGraphicsConfiguration

public GraphicsConfiguration getGraphicsConfiguration()

このメソッドは、この Window が使用する GraphicsConfiguration を返します。

オーバーライド:

クラス Component 内の getGraphicsConfiguration

戻り値:

Component が使用する GraphicsConfiguration、または null

setLocationRelativeTo

public void setLocationRelativeTo(Component c)

指定されたコンポーネントを基準にしてウィンドウの位置を設定します。コンポーネントが現在表示されていない場合、または c が null の場合、ウィンドウは画面の中央に配置されます。コンポーネントの下部がオフスクリーンの場合、ウィンドウはコンポーネントの右に表示されます。

パラメータ:

c - ウィンドウの位置の基準となるコンポーネント

導入されたバージョン:

1.4

createBufferStrategy

public void createBufferStrategy(int numBuffers)

このコンポーネントの新しいマルチバッファリング方法を作成します。マルチバッファリングは描画のレンダリングパフォーマンスに有効です。このメソッドは、提供されたバッファ数で使用できる最善の方式を作成しようとします。これは常にそのバッファ数による BufferStrategy を作成します。最初にページ反転方式が試行され、次に高速バッファを使って Blit 方式が試行されます。最後に、非高速 Blit 方式が使用されます。

このメソッドが呼び出されるごとに、このコンポーネントに対する既存のバッファ方式は破棄されます。

オーバーライド:

クラス Component 内の createBufferStrategy

パラメータ:

numBuffers - 作成するバッファ数

例外:

IllegalArgumentException - numBuffers が 1 より小さい場合

IllegalStateException - コンポーネントが表示可能でない場合

導入されたバージョン:

1.4

関連項目:

Component.isDisplayable(), getBufferStrategy()

createBufferStrategy

public void createBufferStrategy(int numBuffers,
                                 BufferCapabilities caps)
                          throws AWTException

必要なバッファ機能を持つこのコンポーネントのマルチバッファリングの新しい方式を作成します。これは、たとえば高速メモリまたはページ反転だけが必要な場合に有効です (バッファ機能として指定される)。

このメソッドが呼び出されるごとに、このコンポーネントに対する既存のバッファ方式は破棄されます。

オーバーライド:

クラス Component 内の createBufferStrategy

パラメータ:

numBuffers - 作成するバッファ数。フロントバッファを含む

caps - バッファ方式を作成するために必要な機能。null にすることはできない

例外:

AWTException - 提供される機能がサポートされないかまたは対応しない場合。これは、たとえば現在使用可能な高速メモリが十分でない場合、またはページ反転が指定されて実行できない場合などで発生する

IllegalArgumentException - numBuffers が 1 より小さい場合、またはキャップが null の場合

導入されたバージョン:

1.4

関連項目:

getBufferStrategy()

getBufferStrategy

public BufferStrategy getBufferStrategy()

オーバーライド:

クラス Component 内の getBufferStrategy

戻り値:

このコンポーネントで使用されるバッファ方式

導入されたバージョン:

1.4

関連項目:

createBufferStrategy(int)