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

ウィンドウは、ウィンドウイベント WindowOpened および WindowClosed を生成することができます。

導入されたバージョン:

JDK1.0

関連項目:

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

内部クラスの概要

protected class

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

クラス java.awt.Container から継承した内部クラス

Container.AccessibleAWTContainer

クラス java.awt.Component から継承した内部クラス

Component.AccessibleAWTComponent

クラス 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	addWindowListener(WindowListener l) このウィンドウからウィンドウイベントを受け取るために、指定されたウィンドウリスナーを追加します。
void	applyResourceBundle(ResourceBundle rb) この Window に、指定された ResourceBundle の設定値を適用します。
void	applyResourceBundle(String rbName) デフォルトのロケールを使って指定された名前の ResourceBundle をロードし、その設定値をこのウィンドウに適用します。
void	dispose() この Window、そのサブコンポーネントと、その所有されたすべての子によって使用されているすべてのネイティブスクリーンリソースを解放します。
protected void	finalize() インプットメソッドおよびコンテキストを破棄し、この Window を指していた WeakReference を親の所有 Window リストから削除します。
AccessibleContext	getAccessibleContext() この Window に関連した AccessibleContext を返します。
Component	getFocusOwner() このウィンドウがアクティブな場合にだけフォーカスを持つ、このウィンドウの子コンポーネントを返します。
GraphicsConfiguration	getGraphicsConfiguration() このメソッドは、この Window が使用する GraphicsConfiguration を返します。
InputContext	getInputContext() このウィンドウの入力コンテキストを返します。
EventListener[]	getListeners(Class listenerType) addXXXListener() を持つ Window に追加された全リスナーの配列を返します。
Locale	getLocale() ロケールが設定されている場合に、このウィンドウに関連している Locale オブジェクトを返します。
Window[]	getOwnedWindows() 現在このウィンドウが所有しているすべてのウィンドウが格納されている配列を返します。
Window	getOwner() このウィンドウのオーナを返します。
Toolkit	getToolkit() このフレームのツールキットを返します。
String	getWarningString() このウィンドウで表示される警告文字列を返します。
void	hide() この 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 オブジェクトにディスパッチすることにより、ウィンドウイベントを処理します。
void	removeWindowListener(WindowListener l) このウィンドウからウィンドウイベントを受け取らないように、指定されたウィンドウリスナーを削除します。
void	setCursor(Cursor cursor) 指定されたカーソルにそのイメージを設定します。
void	show() Window を表示します。
void	toBack() このウィンドウを背面に移動します。
void	toFront() このウィンドウを前面に移動します。

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

add, add, add, add, add, addContainerListener, addImpl, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getInsets, getLayout, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paint, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setFont, setLayout, update, validate, validateTree

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

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addPropertyChangeListener, addPropertyChangeListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, getBackground, getBounds, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getInputMethodRequests, getLocation, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isDisplayable, isDoubleBuffered, isEnabled, isFocusTraversable, 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, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setDropTarget, setEnabled, setForeground, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, size, toString, transferFocus

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

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

コンストラクタの詳細

Window

public Window(Frame owner)

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

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

パラメータ:

owner - オーナとなる Frame

例外:

IllegalArgumentException - gc がスクリーンデバイスのものではない場合

IllegalArgumentException - owner が null の場合

関連項目:

SecurityManager.checkTopLevelWindow(java.lang.Object)

Window

public Window(Window owner)

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

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

パラメータ:

owner - オーナとなる Window

例外:

IllegalArgumentException - owner が null の場合

導入されたバージョン:

1.2

関連項目:

SecurityManager.checkTopLevelWindow(java.lang.Object)

Window

public Window(Window owner,
              GraphicsConfiguration gc)

指定されたウィンドウをオーナとして、新しい不可視のウィンドウとスクリーンデバイスの GraphicsConfiguration を構築します。

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

パラメータ:

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

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

例外:

IllegalArgumentException - owner が null の場合

IllegalArgumentException - gc がスクリーンデバイスのものではない場合

導入されたバージョン:

1.3

関連項目:

SecurityManager.checkTopLevelWindow(java.lang.Object), GraphicsConfiguration.getBounds()

メソッドの詳細

finalize

protected void finalize()
                 throws Throwable

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

オーバーライド:

クラス Object 内の finalize

クラス java.lang.Object からコピーされたタグ:

例外:

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

このウィンドウを前面に移動します。このウィンドウをスタックの最上位に置き、ほかのすべてのウィンドウの前に表示します。

関連項目:

toBack()

toBack

public void toBack()

このウィンドウを背面に移動します。このウィンドウをスタックの最下位に置いて、ほかの可視ウィンドウを調節します。

関連項目:

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

導入されたバージョン:

1.2

関連項目:

Component.getInputContext()

setCursor

public void setCursor(Cursor cursor)

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

オーバーライド:

クラス Component 内の setCursor

パラメータ:

cursor - Cursor クラスで定義されている定数の 1 つ。このパラメータが null の場合、このウィンドウのカーソルは Cursor.DEFAULT_CURSOR タイプに設定される

導入されたバージョン:

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

public void removeWindowListener(WindowListener l)

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

パラメータ:

l - ウィンドウリスナー

getListeners

public EventListener[] getListeners(Class listenerType)

addXXXListener() を持つ Window に追加された全リスナーの配列を返します。XXX は listenerType の引数の名前です。たとえば、指定された Window w の WindowListener(s) をすべて取得するには、次のように記述します。

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

該当するリスナーリストが存在しない場合は、空の配列が返されます。

オーバーライド:

クラス Container 内の getListeners

パラメータ:

listenerType - 要求されたリスナーのタイプ

戻り値:

このテキストフィールドによってサポートされる、指定されたタイプのすべてのリスナー

導入されたバージョン:

1.3

processEvent

protected void processEvent(AWTEvent e)

このウィンドウのイベントを処理します。イベントが WindowEvent であれば processWindowEvent メソッドを起動し、そうでなければスーパークラスの processEvent を起動します。

オーバーライド:

クラス Container 内の processEvent

パラメータ:

e - イベント

processWindowEvent

protected void processWindowEvent(WindowEvent e)

このウィンドウで発生するウィンドウイベントを、登録されている WindowListener オブジェクトにディスパッチすることにより、ウィンドウイベントを処理します。注: このコンポーネントに対してウィンドウイベントが使用可能でない限り、このメソッドは呼び出されません。これが該当するのは、次の場合です。a) WindowListener オブジェクトが addWindowListener() によって登録されている b) enableEvents() によってウィンドウイベントが使用可能になっている

パラメータ:

e - ウィンドウイベント

関連項目:

Component.enableEvents(long)

getFocusOwner

public Component getFocusOwner()

このウィンドウがアクティブな場合にだけフォーカスを持つ、このウィンドウの子コンポーネントを返します。

戻り値:

フォーカスを持つコンポーネント。どの子もフォーカスがない場合は null

postEvent

public boolean postEvent(Event e)

推奨されていません。 JDK バージョン 1.1 以降は、dispatchEvent(AWTEvent) に置き換えられました。

オーバーライド:

クラス Component 内の postEvent

isShowing

public boolean isShowing()

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

オーバーライド:

クラス Component 内の isShowing

関連項目:

Component.setVisible(boolean)

applyResourceBundle

public void applyResourceBundle(ResourceBundle rb)

この Window に、指定された ResourceBundle の設定値を適用します。現時点では、このメソッドは ResourceBundle の ComponentOrientation を、この Window とその中にあるすべてのコンポーネントに適用します。

導入されたバージョン:

1.2

関連項目:

ComponentOrientation

applyResourceBundle

public void applyResourceBundle(String rbName)

デフォルトのロケールを使って指定された名前の ResourceBundle をロードし、その設定値をこのウィンドウに適用します。現時点では、このメソッドは 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

クラス java.awt.Component からコピーされたタグ:

戻り値:

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