java.awt
クラス Window

java.lang.Object
  java.awt.Component
      java.awt.Container
          java.awt.Window

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

ImageObserver, MenuContainer, Serializable, Accessible

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

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

注:トップレベルウィンドウ (Window、Frame、および Dialog) の位置とサイズはデスクトップのウィンドウ管理システムによって制御されます。setLocation、setSize、および setBounds への呼び出しは要求であり (命令でなく)、ウィンドウ管理システムに転送されます。これらの要求を実行するために必要なすべての処理が行われます しかし、場合によって、ウィンドウ管理システムがそれらの要求を無視したり、デスクトップ設定により厳密に合わせるように Window を配置し、サイズ設定するために、要求された幾何学的図形を変更したりすることがあります。

ネイティブイベント処理は本質的に非同期なため、getBounds、getLocation、getLocationOnScreen、および getSize によって返される結果は、最新の要求が処理されるまで、画面上の Window の実際の幾何学的図形に反映されないことがあります。後続の要求の処理時に、ウィンドウ管理システムが要求を実行するに従い、画面の幾何学的図形の値が更新されます。

アプリケーションでは、不可視の Window のサイズおよび位置を任意で設定できますが、その後、Window が可視状態になると、ウィンドウ管理システムによってサイズや位置が変更される場合があります。新しい幾何学的図形を示すために、1 つ以上の ComponentEvent が生成されます。

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

導入されたバージョン:

JDK1.0

関連項目:

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

入れ子のクラスの概要

protected class

Window.AccessibleAWTWindow このクラスは Window クラス用のアクセシビリティーのサポートを実装しています。

クラス java.awt.Container から継承された入れ子のクラス/インタフェース

Container.AccessibleAWTContainer

クラス java.awt.Component から継承された入れ子のクラス/インタフェース

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

フィールドの概要

クラス java.awt.Component から継承されたフィールド

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

インタフェース java.awt.image.ImageObserver から継承されたフィールド

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

コンストラクタの概要

Window(Frame owner)
オーナーとして指定された Frame を持つ、初期状態で可視ではない新しいウィンドウを構築します。

Window(Window owner)
オーナーとして指定された Window を持つ、初期状態で可視ではない新しいウィンドウを構築します。

Window(Window owner, GraphicsConfiguration gc)
指定されたオーナー Window を持つ初期状態で可視でない新しいウィンドウと、スクリーンデバイスの 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 version 1.4 以降は、 Component.applyComponentOrientation に置き換えられました。
void	applyResourceBundle(String rbName) 推奨されていません。 J2SE version 1.4 以降は、 Component.applyComponentOrientation に置き換えられました。
void	createBufferStrategy(int numBuffers) このコンポーネントの新しいマルチバッファリング方法を作成します。
void	createBufferStrategy(int numBuffers, BufferCapabilities caps) 必要なバッファー機能を持つこのコンポーネントのマルチバッファリングの新しい方式を作成します。
void	dispose() この Window、そのサブコンポーネントと、その所有されたすべての子によって使用されているすべてのネイティブスクリーンリソースを解放します。
AccessibleContext	getAccessibleContext() この Window に関連した AccessibleContext を返します。
BufferStrategy	getBufferStrategy() このコンポーネントが使用する BufferStrategy を返します。
boolean	getFocusableWindowState() isFocusableWindow に概説されたその他の要件に合致する場合に、この Window がフォーカスされた Window になれるかどうかを返します。
Container	getFocusCycleRootAncestor() Window が上位 Window を持たないため、常に null を返します。
Component	getFocusOwner() この Window がフォーカスされている場合は、この Window の子 Component を返します。
Set<AWTKeyStroke>	getFocusTraversalKeys(int id) この Window のフォーカストラバーサルキーを取得します。
GraphicsConfiguration	getGraphicsConfiguration() このメソッドは、この Window が使用する GraphicsConfiguration を返します。
List<Image>	getIconImages() このウィンドウのアイコンとして表示される一連のイメージを返します。
InputContext	getInputContext() このウィンドウの入力コンテキストを返します。
<T extends EventListener> T[]	getListeners(Class<T> listenerType) この Window に FooListener として、現在登録されているすべてのオブジェクトの配列を返します。
Locale	getLocale() ロケールが設定されている場合に、このウィンドウに関連している Locale オブジェクトを返します。
Dialog.ModalExclusionType	getModalExclusionType() このウィンドウのモーダル除外タイプを返します。
Component	getMostRecentFocusOwner() この Window がフォーカスされるときに、フォーカスを受け取るこの Window の子 Component を返します。
Window[]	getOwnedWindows() 現在このウィンドウが所有しているすべてのウィンドウが格納されている配列を返します。
Window	getOwner() このウィンドウのオーナーを返します。
static Window[]	getOwnerlessWindows() このアプリケーションによって作成された、オーナーのいないすべての Window の配列を返します。
Toolkit	getToolkit() このフレームのツールキットを返します。
String	getWarningString() このウィンドウで表示される警告文字列を返します。
WindowFocusListener[]	getWindowFocusListeners() このウィンドウに登録されたすべてのウィンドウフォーカスリスナーの配列を返します。
WindowListener[]	getWindowListeners() このウィンドウに登録されたすべてのウィンドウリスナーの配列を返します。
static Window[]	getWindows() オーナーがいるかどうかにかかわらず、このアプリケーションによって作成されたすべての Window の配列を返します。
WindowStateListener[]	getWindowStateListeners() このウィンドウに登録されたすべてのウィンドウ状態リスナーの配列を返します。
void	hide() 推奨されていません。 JDK version 1.5 以降は、 setVisible(boolean) に置き換えられました。
boolean	isActive() この Window がアクティブであるかどうかを返します。
boolean	isAlwaysOnTop() このウィンドウが最前面ウィンドウであるかどうかを返します。
boolean	isAlwaysOnTopSupported() 最前面モードがこのウィンドウでサポートされているかどうかを返します。
boolean	isFocusableWindow() この Window がフォーカスされた Window になれるかどうか、つまりこの Window またはその任意のサブコンポーネントがフォーカスオーナーになれるかどうかを返します。
boolean	isFocusCycleRoot() すべての Window はフォーカストラバーサルサイクルのルートでなければならないため、常に true を返します。
boolean	isFocused() この Window がフォーカスされているかどうかを返します。
boolean	isLocationByPlatform() 次回にこのウィンドウが可視になったときに、このウィンドウをネィティブウィンドウシステムのデフォルトの場所に表示する場合は true を返します。
boolean	isShowing() この Window が画面に表示されているかどうか判定します。
void	pack() サブコンポーネントの推奨サイズおよびレイアウトに合わせて、この Window をサイズ変更します。
boolean	postEvent(Event e) 推奨されていません。 JDK version 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	removeNotify() ネイティブスクリーンリソースへの接続を削除することにより、この Container を表示不可にします。
void	removeWindowFocusListener(WindowFocusListener l) このウィンドウからウィンドウイベントを受け取らないように、指定されたウィンドウフォーカスリスナーを削除します。
void	removeWindowListener(WindowListener l) このウィンドウからウィンドウイベントを受け取らないように、指定されたウィンドウリスナーを削除します。
void	removeWindowStateListener(WindowStateListener l) このウィンドウからウィンドウイベントを受け取らないように、指定されたウィンドウ状態リスナーを削除します。
void	reshape(int x, int y, int width, int height) 推奨されていません。 JDK version 1.1 以降は、 setBounds(int, int, int, int) に置き換えられました。
void	setAlwaysOnTop(boolean alwaysOnTop) このウィンドウがほかのウィンドウよりも常に前面にあるかどうかを設定します。
void	setBounds(int x, int y, int width, int height) このコンポーネントを移動し、サイズ変更します。
void	setBounds(Rectangle r) 新しい境界の矩形 r に適合するようにこのコンポーネントを移動し、サイズ変更します。
void	setCursor(Cursor cursor) 指定されたカーソルにそのイメージを設定します。
void	setFocusableWindowState(boolean focusableWindowState) isFocusableWindow に概説されたその他の要件に合致する場合に、この Window がフォーカスされた Window になれるかどうかを設定します。
void	setFocusCycleRoot(boolean focusCycleRoot) Window は常にフォーカストラバーサルサイクルのルートであるため、何も操作は行われません。
void	setIconImage(Image image) このウィンドウのアイコンとして表示されるイメージを設定します。
void	setIconImages(List<? extends Image> icons) このウィンドウのアイコンとして表示される一連のイメージを設定します。
void	setLocationByPlatform(boolean locationByPlatform) このウィンドウが次回に可視にされた場合に、ネイティブのウィンドウシステムのデフォルトの場所に表示するか、現在の場所 (getLocation によって返された) に表示するかを設定します。
void	setLocationRelativeTo(Component c) 指定されたコンポーネントを基準にしてウィンドウの位置を設定します。
void	setMinimumSize(Dimension minimumSize) このウィンドウの最小サイズを定数値に設定します。
void	setModalExclusionType(Dialog.ModalExclusionType exclusionType) このウィンドウのモーダル除外タイプを指定します。
void	setSize(Dimension d) このコンポーネントのサイズを、幅 d.width、高さ d.height に変更します。
void	setSize(int width, int height) このコンポーネントのサイズを width および height に変更します。
void	setVisible(boolean b) パラメータ b の値に応じて、この Window を表示または非表示にします。
void	show() 推奨されていません。 JDK version 1.5 以降は、 setVisible(boolean) に置き換えられました。
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, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, 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, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBaseline, getBaselineResizeBehavior, 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, getMousePosition, 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, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, 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, resize, resize, setBackground, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusUpCycle

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

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

コンストラクタの詳細

Window

public Window(Frame owner)

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

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

パラメータ:

owner - オーナーとなる Frame、 このウィンドウにオーナーがいない場合は null

例外:

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

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合

関連項目:

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

Window

public Window(Window owner)

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

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

パラメータ:

owner - オーナーとなる Window、 このウィンドウにオーナーがいない場合は null

例外:

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

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す 場合

導入されたバージョン:

1.2

関連項目:

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

Window

public Window(Window owner,
              GraphicsConfiguration gc)

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

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

パラメータ:

owner - オーナーとなるウィンドウ、 このウィンドウにオーナーがいない場合は null

gc - ターゲットスクリーンデバイスの GraphicsConfiguration。 gc が null の場合は、 システムデフォルトの GraphicsConfiguration が使用される

例外:

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

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す 場合

導入されたバージョン:

1.3

関連項目:

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

メソッドの詳細

getIconImages

public List<Image> getIconImages()

このウィンドウのアイコンとして表示される一連のイメージを返します。

このメソッドは、内部的に格納されたリストのコピーを返します。そのため、返されるオブジェクトでのすべての操作は、ウィンドウの動作には影響しません。

戻り値:

このウィンドウのアイコンイメージのリストのコピー。 このウィンドウにアイコンイメージがない場合は空のリスト

導入されたバージョン:

1.6

関連項目:

setIconImages(java.util.List), setIconImage(Image)

setIconImages

public void setIconImages(List<? extends Image> icons)

このウィンドウのアイコンとして表示される一連のイメージを設定します。以降 getIconImages を呼び出すと、常に icons リストのコピーが返されます。

プラットフォームの性能に応じて、さまざまな寸法の 1 つ以上のイメージがウィンドウのアイコンとして使用されます。

icons リストの先頭から、もっとも適切な寸法のイメージがスキャンされます。リストに同じサイズで複数のイメージが含まれる場合は、最初のイメージが使用されます。

アイコンが指定されていないオーナーのいないウィンドウでは、プラットフォームのデフォルトのアイコンが使用されます。所有ウィンドウのアイコンは、明示的にオーバーライドしないかぎり、オーナーから継承することができます。アイコンを null に設定した場合、または空のリストの場合は、デフォルトの動作が復元されます。

注:ネイティブのウィンドウ管理システムでは、ウィンドウを表すために、コンテキスト (ウィンドウ装飾、ウィンドウリスト、タスクバーなど) に応じてさまざまな寸法のさまざまなイメージを使用する場合があります。また、すべてのコンテキストで単一のイメージを使用することも、まったくイメージを使用しないこともあります。

パラメータ:

icons - 表示されるアイコンイメージのリスト

導入されたバージョン:

1.6

関連項目:

getIconImages(), setIconImage(Image)

setIconImage

public void setIconImage(Image image)

このウィンドウのアイコンとして表示されるイメージを設定します。

ウィンドウのアイコンとして単一イメージを指定するために、このメソッドを setIconImages() の代わりに使用できます。

たとえば次の文を考えてみます。

     setIconImage(image);
 

これは、次と同じです。

     ArrayList imageList = new ArrayList();
     imageList.add(image);
     setIconImages(imageList);
 

注:ネイティブのウィンドウ管理システムでは、ウィンドウを表すために、コンテキスト (ウィンドウ装飾、ウィンドウリスト、タスクバーなど) に応じてさまざまな寸法のさまざまなイメージを使用する場合があります。また、すべてのコンテキストで単一のイメージを使用することも、まったくイメージを使用しないこともあります。

パラメータ:

image - 表示されるアイコンイメージ

導入されたバージョン:

1.6

関連項目:

setIconImages(java.util.List), getIconImages()

addNotify

public void addNotify()

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

オーバーライド:

クラス Container 内の addNotify

導入されたバージョン:

JDK1.0

関連項目:

Component.isDisplayable(), Container.removeNotify()

removeNotify

public void removeNotify()

ネイティブスクリーンリソースへの接続を削除することにより、この Container を表示不可にします。コンテナを表示不可にすると、そのコンテナのすべての子も表示不可になります。このメソッドは、ツールキットによって内部で呼び出され、プログラムから直接呼び出されることはありません。

オーバーライド:

クラス Container 内の removeNotify

関連項目:

Component.isDisplayable(), Container.addNotify()

pack

public void pack()

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

関連項目:

Component.isDisplayable()

setMinimumSize

public void setMinimumSize(Dimension minimumSize)

このウィンドウの最小サイズを定数値に設定します。以降 getMinimumSize を呼び出すと、常にこの値が返されます。現在のウィンドウのサイズが minimumSize 未満である場合、ウィンドウのサイズは最小サイズに合わせて自動的に拡大されます。

あとで setMinimumSize で指定された幅または高さよりも小さい状態で setSize メソッドまたは setBounds メソッドが呼び出されると、ウィンドウは minimumSize の値に合わせて自動的に大きくなります。最小サイズを null に設定すると、デフォルトの動作に戻ります。

ユーザーがウィンドウのサイズを minimumSize の値より小さくしようとすると、サイズ変更操作が制限されることがあります。この動作はプラットフォームに依存します。

オーバーライド:

クラス Component 内の setMinimumSize

パラメータ:

minimumSize - このウィンドウの新しい最小サイズ

導入されたバージョン:

1.6

関連項目:

Component.setMinimumSize(java.awt.Dimension), Container.getMinimumSize(), Component.isMinimumSizeSet(), setSize(Dimension)

setSize

public void setSize(Dimension d)

このコンポーネントのサイズを、幅 d.width、高さ d.height に変更します。

d.width および d.height の値は、いずれかが直前の setMinimumSize の呼び出しで指定された最小サイズよりも小さい場合、自動的に大きくなります。

オーバーライド:

クラス Component 内の setSize

パラメータ:

d - このコンポーネントの新しいサイズを 指定する寸法

導入されたバージョン:

1.6

関連項目:

Component.getSize(), setBounds(int, int, int, int), setMinimumSize(java.awt.Dimension)

setSize

public void setSize(int width,
                    int height)

このコンポーネントのサイズを width および height に変更します。

width および height の値は、いずれかが直前の setMinimumSize の呼び出しで指定された最小サイズよりも小さい場合、自動的に大きくなります。

オーバーライド:

クラス Component 内の setSize

パラメータ:

width - このコンポーネントの新しい幅 (ピクセル単位)

height - このコンポーネントの新しい高さ (ピクセル単位)

導入されたバージョン:

1.6

関連項目:

Component.getSize(), setBounds(int, int, int, int), setMinimumSize(java.awt.Dimension)

reshape

@Deprecated
public void reshape(int x,
                               int y,
                               int width,
                               int height)

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

オーバーライド:

クラス Component 内の reshape

setVisible

public void setVisible(boolean b)

パラメータ b の値に応じて、この Window を表示または非表示にします。

オーバーライド:

クラス Component 内の setVisible

パラメータ:

b - true の場合、Window を可視状態にし、 そうでない場合は Window を非表示にする。 Window やそのオーナーが まだ表示可能でない場合は、どちらも表示可能状態にされる。 Window は、可視状態にされる前に検証される。 Window がすでに可視状態である場合は、 Window が前面に移動する。

false の場合、この Window、そのサブコンポーネント、およびその所有されたすべての子が 非表示になる。 #setVisible(true) を呼び出すと、Window とそのサブコンポーネントを ふたたび可視状態にできる

関連項目:

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

show

@Deprecated
public void show()

推奨されていません。 JDK version 1.5 以降は、 setVisible(boolean) に置き換えられました。

Window を可視にします。Window およびそのオーナーがまだ表示可能でない場合は、両方とも表示可能にします。Window は、可視状態にされる前に検証されます。Window がすでに可視状態である場合、Window は前面に移行します。

オーバーライド:

クラス Component 内の show

関連項目:

Component.isDisplayable(), toFront()

hide

@Deprecated
public void hide()

推奨されていません。 JDK version 1.5 以降は、 setVisible(boolean) に置き換えられました。

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

オーバーライド:

クラス Component 内の hide

関連項目:

show(), dispose()

dispose

public void dispose()

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

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

注:Java 仮想マシン (VM) 内で最後の表示可能なウィンドウが破棄されると、VM が終了することがあります。詳細については、「AWT Threading Issues」を参照してください。

関連項目:

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

toFront

public void toFront()

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

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

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

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

このウィンドウがモーダルダイアログでブロックされると、ブロックしたダイアログが前面に移動し、ブロックされたウィンドウの上に表示されます。

関連項目:

toBack()

toBack

public void toBack()

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

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

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

関連項目:

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)

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

Java プラットフォームの実装やネイティブシステムでマウスカーソルの形状変更がサポートされていない場合、このメソッドには視覚効果がない場合があります。

オーバーライド:

クラス Component 内の setCursor

パラメータ:

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

導入されたバージョン:

JDK1.1

関連項目:

Component.getCursor(), Cursor

getOwner

public Window getOwner()

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

導入されたバージョン:

1.2

getOwnedWindows

public Window[] getOwnedWindows()

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

導入されたバージョン:

1.2

getWindows

public static Window[] getWindows()

オーナーがいるかどうかにかかわらず、このアプリケーションによって作成されたすべての Window の配列を返します。アプレットから呼び出された場合、配列にはそのアプレットがアクセスできる Window だけが含まれます。

警告:このメソッドは、システムが作成したウィンドウ (印刷ダイアログなど) を返す場合があります。アプリケーションでは、このようなダイアログが存在することを想定していません。また、このようなダイアログに関しては、コンポーネントの位置、LayoutManager、直列化なども想定していません。

導入されたバージョン:

1.6

関連項目:

Frame.getFrames(), getOwnerlessWindows()

getOwnerlessWindows

public static Window[] getOwnerlessWindows()

このアプリケーションによって作成された、オーナーのいないすべての Window の配列を返します。Frame 、およびオーナーのいない Dialog と Window が含まれます。アプレットから呼び出された場合、配列にはそのアプレットがアクセスできる Window だけが含まれます。

警告:このメソッドは、システムが作成したウィンドウ (印刷ダイアログなど) を返す場合があります。アプリケーションでは、このようなダイアログが存在することを想定していません。また、このようなダイアログに関しては、コンポーネントの位置、LayoutManager、直列化なども想定していません。

導入されたバージョン:

1.6

関連項目:

Frame.getFrames(), getWindows(sun.awt.AppContext)

setModalExclusionType

public void setModalExclusionType(Dialog.ModalExclusionType exclusionType)

このウィンドウのモーダル除外タイプを指定します。ウィンドウがモーダル除外である場合は、モーダルダイアログによってブロックされない場合があります。設定可能なモーダル除外タイプについては、Dialog.ModalExclusionType を参照してください。

指定されたタイプがサポートされていない場合、NO_EXCLUDE が使用されます。

注:可視ウィンドウのモーダル除外タイプを変更しても、いったん非表示にしてから再度表示するまで、変更が反映されないことがあります。

パラメータ:

exclusionType - このウィンドウのモーダル除外タイプ。null 値は、 NO_EXCLUDE と 同等

例外:

SecurityException - 呼び出し側スレッドに、 指定された exclusionType を持つウィンドウに対して、 モーダル除外プロパティーを設定するアクセス権がない場合

導入されたバージョン:

1.6

関連項目:

Dialog.ModalExclusionType, getModalExclusionType(), Toolkit.isModalExclusionTypeSupported(java.awt.Dialog.ModalExclusionType)

getModalExclusionType

public Dialog.ModalExclusionType getModalExclusionType()

このウィンドウのモーダル除外タイプを返します。

戻り値:

このウィンドウのモーダル除外タイプ

導入されたバージョン:

1.6

関連項目:

Dialog.ModalExclusionType, setModalExclusionType(java.awt.Dialog.ModalExclusionType)

addWindowListener

public void addWindowListener(WindowListener l)

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

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

パラメータ:

l - ウィンドウリスナー

関連項目:

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

addWindowStateListener

public void addWindowStateListener(WindowStateListener l)

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

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

パラメータ:

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

導入されたバージョン:

1.4

関連項目:

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

addWindowFocusListener

public void addWindowFocusListener(WindowFocusListener l)

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

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

パラメータ:

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

導入されたバージョン:

1.4

関連項目:

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

removeWindowListener

public void removeWindowListener(WindowListener l)

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

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

パラメータ:

l - ウィンドウリスナー

関連項目:

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

removeWindowStateListener

public void removeWindowStateListener(WindowStateListener l)

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

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

パラメータ:

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

導入されたバージョン:

1.4

関連項目:

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

removeWindowFocusListener

public void removeWindowFocusListener(WindowFocusListener l)

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

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

パラメータ:

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

導入されたバージョン:

1.4

関連項目:

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 <T extends EventListener> T[] getListeners(Class<T> 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 - イベント

関連項目:

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)

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 - ウインドウフォーカスイベント

導入されたバージョン:

1.4

関連項目:

Component.enableEvents(long)

processWindowStateEvent

protected void processWindowStateEvent(WindowEvent e)

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

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

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

パラメータ:

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

導入されたバージョン:

1.4

関連項目:

Component.enableEvents(long)

setAlwaysOnTop

public final void setAlwaysOnTop(boolean alwaysOnTop)
                          throws SecurityException

このウィンドウがほかのウィンドウよりも常に前面にあるかどうかを設定します。最前面ウィンドウが複数ある場合は、その相対順序は指定されず、プラットフォームに依存します。

ほかに最前面ウィンドウがある場合、これらのウィンドウの相対的な順序は指定されず、プラットフォームに依存します。別の最前面ウィンドウ以外には、最前面ウィンドウの手前に通常のウィンドウを配置することはできません。

最前面ウィンドウに属するすべてのウィンドウは、その状態を継承し、自動的に最前面ウィンドウになります。該当するウィンドウが最前面でなくなった場合、それに属するウィンドウも最前面でなくなります。最前面ウィンドウに toBack を送ると、その最前面の状態が false に設定されます。

ウィンドウでこのメソッドが値 true で呼び出され、そのウィンドウが可視状態で、さらにプラットフォームでそのウィンドウについて最前面をサポートしている場合、そのウィンドウはすぐに前面に移動されて最前面の位置に「固定」されます。ウィンドウが現在可視状態でない場合、このメソッドは最前面状態を true に設定しますが、ウィンドウを前面に移動しません。あとでウィンドウが表示された場合、最前面に表示されます。

ウィンドウでこのメソッドが値 false で呼び出される場合、最前面状態は標準に設定されます。ウィンドウは最前面に表示されていますが、その Z 軸順をほかのウィンドウと同じ方法で変更できます。標準状態のウィンドウでこのメソッドを値 false で呼び出しても、何も起こりません。最前面状態を false に設定しても、最前面ウインドウがほかに存在しない場合は、ウィンドウの相対 Z 軸順は何も変化しません。

注:最前面ウィンドウをサポートしていないプラットフォームもあります。現在のプラットフォームで最前面ウィンドウがサポートされていることを検出するには、Toolkit.isAlwaysOnTopSupported() および isAlwaysOnTopSupported() を使用します。ツールキットやこのウィンドウで最前面モードがサポートされていない場合は、このメソッドを呼び出しても何も起こりません。

SecurityManager がインストールされている場合、呼び出し側スレッドはこのプロパティーの値を設定するために、AWTPermission である「setWindowAlwaysOnTop」が与えられている必要があります。このアクセス権が与えられていない場合、このメソッドは SecurityException をスローし、現在のプロパティーの値は変更されません。

パラメータ:

alwaysOnTop - ウィンドウをほかのウィンドウよりも常に前面にする場合は true

例外:

SecurityException - 呼び出し側スレッドに、最前面プロパティーの値を 設定するアクセス権がない場合

導入されたバージョン:

1.5

関連項目:

isAlwaysOnTop(), toFront(), toBack(), AWTPermission, isAlwaysOnTopSupported(), Toolkit.isAlwaysOnTopSupported()

isAlwaysOnTopSupported

public boolean isAlwaysOnTopSupported()

最前面モードがこのウィンドウでサポートされているかどうかを返します。プラットフォームによっては、最前面ウィンドウをサポートしていなかったり、サポートするトップレベルウィンドウの種類が限定されていたりします。たとえば、最前面モーダルダイアログをサポートしていないプラットフォームもあります。

戻り値:

ツールキットやこのウィンドウで最前面モードが サポートされている場合は true、 このウィンドウで最前面モードがサポートされていない場合、 またはツールキットで最前面ウィンドウがサポートされていない場合は false

導入されたバージョン:

1.6

関連項目:

setAlwaysOnTop(boolean), Toolkit.isAlwaysOnTopSupported()

isAlwaysOnTop

public final boolean isAlwaysOnTop()

このウィンドウが最前面ウィンドウであるかどうかを返します。

戻り値:

ウィンドウが最前面状態である場合は true、 そうでない場合は false

導入されたバージョン:

1.5

関連項目:

setAlwaysOnTop(boolean)

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<AWTKeyStroke> getFocusTraversalKeys(int id)

この Window のフォーカストラバーサルキーを取得します。すべてのキーの説明は setFocusTraversalKeys を参照してください。

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

オーバーライド:

クラス Container 内の getFocusTraversalKeys

パラメータ:

id - KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、 KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、 KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS、 KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS のいずれか

戻り値:

指定されたキーの AWTKeyStroke

例外:

IllegalArgumentException - id が KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS、 KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS、 KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS、 KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS のどれでもない場合

導入されたバージョン:

1.4

関連項目:

Container.setFocusTraversalKeys(int, java.util.Set), KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS

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 の標準の機構です。 可視状態の Window にフォーカス特性を設定すると、一部のプラットフォームに遅延が発生します。 つまり、実際の変更は Window が非表示になり、そのあとに再度可視状態になった場合にのみ反映されるということです。プラットフォーム間の動作に整合性を持たせるため、Window が不可視状態になったときに Window をフォーカス可能な状態に設定し、そのあとに表示するようにします。

パラメータ:

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 の常に最上の状態 ("alwaysOnTop")

この 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 の常に最上の状態 ("alwaysOnTop")

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

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

オーバーライド:

クラス Container 内の addPropertyChangeListener

パラメータ:

propertyName - 上記のプロパティー名のいずれか

listener - 追加する PropertyChangeListener

関連項目:

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

postEvent

@Deprecated
public boolean postEvent(Event e)

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

定義:

インタフェース MenuContainer 内の postEvent

オーバーライド:

クラス Component 内の postEvent

isShowing

public boolean isShowing()

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

オーバーライド:

クラス Component 内の isShowing

戻り値:

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

関連項目:

Component.setVisible(boolean)

applyResourceBundle

@Deprecated
public void applyResourceBundle(ResourceBundle rb)

推奨されていません。 J2SE version 1.4 以降は、 Component.applyComponentOrientation に置き換えられました。

applyResourceBundle

@Deprecated
public void applyResourceBundle(String rbName)

推奨されていません。 J2SE version 1.4 以降は、 Component.applyComponentOrientation に置き換えられました。

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス Component 内の getAccessibleContext

戻り値:

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

導入されたバージョン:

1.3

getGraphicsConfiguration

public GraphicsConfiguration getGraphicsConfiguration()

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

オーバーライド:

クラス Component 内の getGraphicsConfiguration

戻り値:

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

導入されたバージョン:

1.3

setLocationRelativeTo

public void setLocationRelativeTo(Component c)

指定されたコンポーネントを基準にしてウィンドウの位置を設定します。

コンポーネントが現在表示されていない場合、または c が null の場合、ウィンドウは画面の中央に配置されます。中央点は、GraphicsEnvironment.getCenterPoint で決定されます。

コンポーネントの下部がオフスクリーンの場合、ウィンドウは Component の画面の中央に近い方の側に表示されます。つまり、Component が画面の右側にある場合、Window はその左側に配置され、Component が左側にある場合、Window はその右側に配置されます。

パラメータ:

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

導入されたバージョン:

1.4

関連項目:

GraphicsEnvironment.getCenterPoint()

createBufferStrategy

public void createBufferStrategy(int numBuffers)

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

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

パラメータ:

numBuffers - 作成するバッファー数

例外:

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

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

導入されたバージョン:

1.4

関連項目:

Component.isDisplayable(), getBufferStrategy()

createBufferStrategy

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

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

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

パラメータ:

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

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

例外:

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

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

導入されたバージョン:

1.4

関連項目:

getBufferStrategy()

getBufferStrategy

public BufferStrategy getBufferStrategy()

このコンポーネントが使用する BufferStrategy を返します。BufferStrategy が作成されていないか破棄されていると、このメソッドは null を返します。

戻り値:

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

導入されたバージョン:

1.4

関連項目:

createBufferStrategy(int)

setLocationByPlatform

public void setLocationByPlatform(boolean locationByPlatform)

このウィンドウが次回に可視にされた場合に、ネイティブのウィンドウシステムのデフォルトの場所に表示するか、現在の場所 (getLocation によって返された) に表示するかを設定します。この動作はプログラムでその位置を設定しない場合のネィティブのウィンドウの表示に似ています。ほとんどのウィンドウシステムでは、それらの場所が明示的に設定されない場合に、ウィンドウをカスケード表示します。実際の場所はウィンドウが画面に表示されるときに判断されます。

この動作はシステムプロパティー "java.awt.Window.locationByPlatform" を "true" に設定することによっても有効にできます。 ただし、このメソッドへの呼び出しが優先されます。

setLocationByPlatform の呼び出しのあとに setVisible、setLocation、および setBounds を呼び出すと、Windows のこのプロパティーがクリアされます。

たとえば、次のコードの実行後です。

 setLocationByPlatform(true);
 setVisible(true);
 boolean flag = isLocationByPlatform();
 

ウィンドウはプラットフォームのデフォルトの位置に表示され、flag は false になります。

次に例を示します。

 setLocationByPlatform(true);
 setLocation(10, 10);
 boolean flag = isLocationByPlatform();
 setVisible(true);
 

ウィンドウはプラットフォームの (10, 10) の位置に表示され、flag は false になります。

パラメータ:

locationByPlatform - この Window をデフォルトの位置に表示する場合は true、 現在の位置に表示する場合は false

例外:

IllegalComponentStateException - ウィンドウが 画面上に表示されており、locationByPlatform が true の場合

導入されたバージョン:

1.5

関連項目:

Component.setLocation(int, int), isShowing(), setVisible(boolean), isLocationByPlatform(), System.getProperty(String)

isLocationByPlatform

public boolean isLocationByPlatform()

次回にこのウィンドウが可視になったときに、このウィンドウをネィティブウィンドウシステムのデフォルトの場所に表示する場合は true を返します。このメソッドは、ウィンドウが画面上に表示されている場合は常に false を返します。

戻り値:

このウィンドウをデフォルトの場所に表示するかどうか

導入されたバージョン:

1.5

関連項目:

setLocationByPlatform(boolean), isShowing()

setBounds

public void setBounds(int x,
                      int y,
                      int width,
                      int height)

このコンポーネントを移動し、サイズ変更します。左上隅の新しい位置は x および y によって指定され、新しいサイズは width および height によって指定されます。

width または height の値は、いずれかが直前の setMinimumSize の呼び出しで指定された最小サイズよりも小さい場合、自動的に大きくなります。

オーバーライド:

クラス Component 内の setBounds

パラメータ:

x - このコンポーネントの新しい x 座標

y - このコンポーネントの新しい y 座標

width - このコンポーネントの新しい width

height - このコンポーネントの新しい height

導入されたバージョン:

1.6

関連項目:

Component.getBounds(), Component.setLocation(int, int), Component.setLocation(Point), setSize(int, int), setSize(Dimension), setMinimumSize(java.awt.Dimension), setLocationByPlatform(boolean), isLocationByPlatform()

setBounds

public void setBounds(Rectangle r)

新しい境界の矩形 r に適合するようにこのコンポーネントを移動し、サイズ変更します。このコンポーネントの新しい位置は r.x および r.y によって指定され、新しいサイズは r.width および r.height によって指定されます。

r.width または r.height の値は、いずれかが直前の setMinimumSize の呼び出しで指定された最小サイズよりも小さい場合、自動的に大きくなります。

オーバーライド:

クラス Component 内の setBounds

パラメータ:

r - このコンポーネントの新しい境界の矩形

導入されたバージョン:

1.6

関連項目:

Component.getBounds(), Component.setLocation(int, int), Component.setLocation(Point), setSize(int, int), setSize(Dimension), setMinimumSize(java.awt.Dimension), setLocationByPlatform(boolean), isLocationByPlatform()