クラス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オブジェクトです。

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

このような環境では、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を配置し、サイズ設定するために、要求された幾何学的図形を変更したりすることがあります。

ロー、シャドウ、モー・ション・エフェクト、アニメーションなどの視覚効果は、デスクトップ・ウィンドウ管理システ� によってウィンドウに適用できます。 これらはAWTの知識および制御外であるため、この仕様の目的で、トップレベル・ウィンドウの一部とはみなされません。

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

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

ウィンドウは、WindowOpened、WindowClosed、WindowGainedFocus、およびWindowLostFocusのWindowEventを生成できます。

導入されたバージョン:

1.0

関連� �目:

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

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラス	説明
protected class	Window.AccessibleAWTWindow	このクラスはWindowクラスのアクセシビリティ・サポートを実装しています。
static enum	Window.Type	使用可能なウィンドウ・タイプの列挙。

クラスjava.awt.Containerで宣言されたネストされたクラス/インタフェース

Container.AccessibleAWTContainer

クラスjava.awt.Componentで宣言されたネストされたクラス/インタフェース

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

フィールドのサマリー

クラスjava.awt.Componentで宣言されたフィールド

accessibleContext, 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(String rbName)	非推奨。 J2SE 1.4から、Component.applyComponentOrientationに置き換えられました。
void	applyResourceBundle(ResourceBundle rb)	非推奨。 J2SE 1.4から、Component.applyComponentOrientationに置き換えられました。
void	createBufferStrategy(int numBuffers)	このコンポーネントの新しいマルチバッファリング方法を作成します。
void	createBufferStrategy(int numBuffers, BufferCapabilities caps)	必要なバッファ機能を持つこのコンポーネントのマルチバッファリングの新しい方式を作成します。
void	dispose()	このWindow、そのサブコンポーネント、およびその所有されたすべての子によって使用されるすべてのネイティブ画面リソースを解放します。
AccessibleContext	getAccessibleContext()	このWindowに関連付けられたAccessibleContextを取得します。
Color	getBackground()	このウィンドウの背景色を取得します。
BufferStrategy	getBufferStrategy()	このコンポーネントによって使用されるBufferStrategyを返します。
boolean	getFocusableWindowState()	isFocusableWindowで概説されているほかの要件を満たす� �合に、このウィンドウがフォーカスされたウィンドウになれるかどうかを返します。
final Container	getFocusCycleRootAncestor()	ウィンドウに上位コンポーネントがないため、常にnullを返します。これらは、Component階層の最上位を表します。
Component	getFocusOwner()	このWindowがフォーカスされている� �合は、このWindowの子Componentを返します。そうでない� �合はnullを返します。
Set<AWTKeyStroke>	getFocusTraversalKeys(int id)	このWindowのフォーカス・トラバーサル・キーを取得します。
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を返します。
float	getOpacity()	ウィンドウの不透明性を返します。
Window[]	getOwnedWindows()	現在このウィンドウが所有しているすべてのウィンドウが� �納されている配列を返します。
Window	getOwner()	このウィンドウのオーナーを返します。
static Window[]	getOwnerlessWindows()	オーナーのいない、このアプリケーションによって作成されたすべてのWindowの配列を返します。
Shape	getShape()	ウィンドウの形状を返します。
Toolkit	getToolkit()	このフレー� のツールキットを返します。
Window.Type	getType()	ウィンドウのタイプを返します。
final String	getWarningString()	削除予定のため非推奨: このAPI要� は、将来のバージョンで削除される可能性があります。 JDK 24以降
WindowFocusListener[]	getWindowFocusListeners()	このウィンドウに登録されたすべてのウィンドウ・フォーカス・リスナーの配列を返します。
WindowListener[]	getWindowListeners()	このウィンドウに登録されたすべてのウィンドウ・リスナーの配列を返します。
static Window[]	getWindows()	このアプリケーションによって作成されたすべてのWindow (オーナーがいる� �合といない� �合の両方)の配列を返します。
WindowStateListener[]	getWindowStateListeners()	このウィンドウに登録されたすべてのウィンドウ状態リスナーの配列を返します。
void	hide()	非推奨。 JDKバージョン1.5で、setVisible(boolean)に置き換えられています。
boolean	isActive()	このWindowがアクティブであるかどうかを返します。
final boolean	isAlwaysOnTop()	このウィンドウが最前面ウィンドウであるかどうかを返します。
boolean	isAlwaysOnTopSupported()	最前面モードがこのウィンドウでサポートされているかどうかを返します。
boolean	isAutoRequestFocus()	このウィンドウが、そのあとに表示されるフォーカス(setVisible(true)の呼出しを使用)、または前面に移動されるフォーカス(toFront()の呼出しを使用)のどちらを受信するかを返します。
final boolean	isFocusableWindow()	このWindowがフォーカスされたWindowになれるかどうか、つまりこのWindowまたはその任意のサブコンポーネントがフォーカス・オーナーになれるかどうかを返します。
final boolean	isFocusCycleRoot()	すべてのウィンドウはフォーカス・トラバーサル・サイクルのルートである必要があるため、常にtrueを返します。
boolean	isFocused()	このWindowがフォーカスされているかどうかを返します。
boolean	isLocationByPlatform()	このウィンドウが次回表示されるときに、このウィンドウをネイティブ・ウィンドウ・システ� のデフォルトの位置に表示する� �合はtrueを返します。
boolean	isOpaque()	ウィンドウが現在不透明かどうかを示します。
boolean	isShowing()	このWindowが画面に表示されているかどうか判定します。
boolean	isValidateRoot()	このコンテナが有効なルートであるかどうかを示します。
void	pack()	サブコンポーネントの推奨サイズおよびレイアウトに合わせて、このWindowをサイズ変更します。
void	paint(Graphics g)	コンテナをペイントします。
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	reshape(int x, int y, int width, int height)	非推奨。 JDKバージョン1.1で、setBounds(int, int, int, int)に置き換えられています。
final void	setAlwaysOnTop(boolean alwaysOnTop)	このウィンドウがほかのウィンドウよりも常に前面にあるかどうかを設定します。
void	setAutoRequestFocus(boolean autoRequestFocus)	このウィンドウが、そのあとに表示されるフォーカス(setVisible(true)の呼出しを使用)、または前面に移動されるフォーカス(toFront()の呼出しを使用)のどちらを受信するかを設定します。
void	setBackground(Color bgColor)	このウィンドウの背景色を設定します。
void	setBounds(int x, int y, int width, int height)	このコンポーネントを移動し、サイズ変更します。
void	setBounds(Rectangle r)	新しい境界の矩形rに適合するように、このコンポーネントを移動し、サイズ変更します。
void	setCursor(Cursor cursor)	指定されたカーソルにそのイメージを設定します。
void	setFocusableWindowState(boolean focusableWindowState)	isFocusableWindowで概説されているほかの要件を満たす� �合に、このウィンドウがフォーカスされたウィンドウになれるかどうかを設定します。
final void	setFocusCycleRoot(boolean focusCycleRoot)	Windowは常にフォーカス・トラバーサル・サイクルのルートであるため、何も操作は行われません。
void	setIconImage(Image image)	このウィンドウのアイコンとして表示されるイメージを設定します。
void	setIconImages(List<? extends Image> icons)	このウィンドウのアイコンとして表示される一連のイメージを設定します。
void	setLocation(int x, int y)	このコンポーネントを新しい位置に移動します。
void	setLocation(Point p)	このコンポーネントを新しい位置に移動します。
void	setLocationByPlatform(boolean locationByPlatform)	このウィンドウが次回表示されるときに、このウィンドウをネイティブ・ウィンドウ・システ� のデフォルトの位置、または(getLocationによって返された)現在の位置のどちらに表示するかを設定します。
void	setLocationRelativeTo(Component c)	次のシナリオに応じて、指定されたコンポーネントを基準にしたウィンドウの位置を設定します。
void	setMinimumSize(Dimension minimumSize)	このウィンドウの最小サイズを定数値に設定します。
void	setModalExclusionType(Dialog.ModalExclusionType exclusionType)	このウィンドウのモーダル除外タイプを指定します。
void	setOpacity(float opacity)	ウィンドウの不透明性を設定します。
void	setShape(Shape shape)	ウィンドウの形状を設定します。
void	setSize(int width, int height)	幅がwidthで、高さがheightになるように、このコンポーネントのサイズを変更します。
void	setSize(Dimension d)	幅がd.widthで、高さがd.heightになるように、このコンポーネントのサイズを変更します。
void	setType(Window.Type type)	ウィンドウのタイプを設定します。
void	setVisible(boolean b)	パラメータbの値に応じて、このWindowを表示または非表示にします。
void	show()	非推奨。 JDKバージョン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, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, 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, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, 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, 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, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setMixingCutoutShape, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

クラスjava.lang.Objectで宣言されたメソッド

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

コンストラクタの詳細

Window

public Window(Frame owner)

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

パラメータ:

owner - オーナーとして機能するFrame、またはこのウィンドウにオーナーがいない� �合はnull

スロー:

IllegalArgumentException - ownerのGraphicsConfigurationが画面デバイスのものでない� �合

HeadlessException - GraphicsEnvironment.isHeadlessがtrueを返した� �合

関連� �目:

• GraphicsEnvironment.isHeadless()
• isShowing()

Window

public Window(Window owner)

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

パラメータ:

owner - オーナーとして機能するWindow、またはこのウィンドウにオーナーがいない� �合はnull

スロー:

IllegalArgumentException - ownerのGraphicsConfigurationが画面デバイスのものでない� �合

HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した� �合

導入されたバージョン:

1.2

関連� �目:

• GraphicsEnvironment.isHeadless()
• isShowing()

Window

public Window(Window owner, GraphicsConfiguration gc)

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

パラメータ:

owner - オーナーとして機能するウィンドウ。このウィンドウにオーナーがいない� �合はnull

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

スロー:

IllegalArgumentException - gcが画面デバイスのものでない� �合

HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した� �合

導入されたバージョン:

1.3

関連� �目:

• GraphicsEnvironment.isHeadless()
• GraphicsConfiguration.getBounds()
• isShowing()

メソッドの詳細

getIconImages

public List<Image> getIconImages()

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

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

戻り値:

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

導入されたバージョン:

1.6

関連� �目:

• setIconImages(java.util.List<? extends java.awt.Image>)
• setIconImage(Image)

setIconImages

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

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

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

iconsリストには、MultiResolutionImageイメージを含めることもできます。 画面解像度に応じた適切なイメージは、ベースMultiResolutionImageイメージから抽出され、アイコン・リストに追� されますが、ベース解像度イメージはリストから削除されます。 iconsリストの先� �から、もっとも適切な寸法のイメージがスキャンされます。 リストに同じサイズで複数のイメージが含まれる� �合は、最初のイメージが使用されます。

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

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

パラメータ:

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

導入されたバージョン:

1.6

関連� �目:

• getIconImages()
• setIconImage(Image)

setIconImage

public void setIconImage(Image image)

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

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

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

     setIconImage(image);
 

は、次と同じです。

     ArrayList<Image> imageList = new ArrayList<Image>();
     imageList.add(image);
     setIconImages(imageList);
 

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

パラメータ:

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

導入されたバージョン:

1.6

関連� �目:

• setIconImages(java.util.List<? extends java.awt.Image>)
• getIconImages()

addNotify

public void addNotify()

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

オーバーライド:

addNotify、クラスContainer

導入されたバージョン:

1.0

関連� �目:

• Component.isDisplayable()
• Container.removeNotify()

pack

public void pack()

サブコンポーネントの推奨サイズおよびレイアウトに合わせて、このWindowをサイズ変更します。 その結果、ウィンドウの幅と高さのどちらかが直前のsetMinimumSizeメソッドの呼出しで指定された最小サイズより小さい� �合、ウィンドウは自動的に大きくなります。

ウィンドウおよびそのオーナーがま� 表示可能でない� �合は、両方とも表示可能にしてから推奨サイズを計算します。 Windowのサイズが計算されたあと、Windowの検証が行われます。

関連� �目:

• Component.isDisplayable()
• setMinimumSize(java.awt.Dimension)

setMinimumSize

public void setMinimumSize(Dimension minimumSize)

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

あとで、setMinimumSizeメソッドで指定された幅または高さよりも小さい寸法でsetSizeメソッドまたはsetBoundsメソッドが呼び出されると、ウィンドウはminimumSizeの値に合わせて自動的に大きくなります。 minimumSizeの値はpackメソッドの動作にも影響を与えます。

最小サイズのパラメータをnull値に設定すると、デフォルトの動作が復元されます。

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

オーバーライド:

setMinimumSize、クラスComponent

パラメータ:

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

導入されたバージョン:

1.6

関連� �目:

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

setSize

public void setSize(Dimension d)

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

このメソッドではレイアウトに関連する情� �が変更されるため、コンポーネント階層が無効になります。

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

このメソッドは、幾何学的図形に関連するデータを変更します。 そのため、Windowオブジェクトがデスクトップ設定に厳密に対応する方法で配置およびサイズ設定されるように、ネイティブ・ウィンドウ管理システ� はこのような要求を無視するか、または要求されたデータを変更する可能性があります。

オーバーライド:

setSize、クラスComponent

パラメータ:

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の呼出しによって指定された最小サイズより小さい� �合、自動的に大きくなります。

このメソッドは、幾何学的図形に関連するデータを変更します。 そのため、Windowオブジェクトがデスクトップ設定に厳密に対応する方法で配置およびサイズ設定されるように、ネイティブ・ウィンドウ管理システ� はこのような要求を無視するか、または要求されたデータを変更する可能性があります。

オーバーライド:

setSize、クラスComponent

パラメータ:

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

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

導入されたバージョン:

1.6

関連� �目:

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

setLocation

public void setLocation(int x, int y)

このコンポーネントを新しい位置に移動します。 新しい位置の左上隅は、このコンポーネントの親の座標空間内のxおよびyパラメータによって指定されます。

このメソッドではレイアウトに関連する情� �が変更されるため、コンポーネント階層が無効になります。

このメソッドは、幾何学的図形に関連するデータを変更します。 そのため、Windowオブジェクトがデスクトップ設定に厳密に対応する方法で配置およびサイズ設定されるように、ネイティブ・ウィンドウ管理システ� はこのような要求を無視するか、または要求されたデータを変更する可能性があります。

オーバーライド:

setLocation、クラスComponent

パラメータ:

x - 親の座標空間内の新しい位置の左上隅のx座標

y - 親の座標空間内の新しい位置の左上隅のy座標

関連� �目:

• Component.getLocation()
• Component.setBounds(int, int, int, int)
• Component.invalidate()

setLocation

public void setLocation(Point p)

このコンポーネントを新しい位置に移動します。 新しい位置の左上隅は、点pによって指定されます。 点pは、親の座標空間で指定されます。

このメソッドではレイアウトに関連する情� �が変更されるため、コンポーネント階層が無効になります。

このメソッドは、幾何学的図形に関連するデータを変更します。 そのため、Windowオブジェクトがデスクトップ設定に厳密に対応する方法で配置およびサイズ設定されるように、ネイティブ・ウィンドウ管理システ� はこのような要求を無視するか、または要求されたデータを変更する可能性があります。

オーバーライド:

setLocation、クラスComponent

パラメータ:

p - このコンポーネントの親の座標空間で指定された、新しい位置の左上隅を定義する点

関連� �目:

• Component.getLocation()
• Component.setBounds(int, int, int, int)
• Component.invalidate()

reshape

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

非推奨。

JDKバージョン1.1で、setBounds(int, int, int, int)に置き換えられています。

次のクラスからコピーされた説明: Component

このコンポーネントの境界矩形を再形成します。

オーバーライド:

reshape、クラスComponent

パラメータ:

x - 矩形の左上隅のx座標

y - 矩形の左上隅のy座標

width - 矩形の幅

height - 矩形の高さ

setVisible

public void setVisible(boolean b)

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

このメソッドでウィンドウを表示する� �合、次の条件下ではウィンドウにフォーカスも設定されます。

• WindowがisFocusableWindow()メソッドで概説されている要件を満たしている。
• WindowのautoRequestFocusプロパティの値がtrueである。
• このWindowがフォーカスを取得することが、ネイティブのウィンドウ処理システ� で許可されている。

2番目の条件(autoRequestFocusプロパティの値)には例外があります。 ウィンドウがモーダル・ダイアログの� �合、このプロパティは考慮されず、現在フォーカスのあるウィンドウがブロックされます。

開発者は、このウィンドウがWINDOW_GAINED_FOCUSまたはWINDOW_ACTIVATEDイベントを受け取るまで、このウィンドウがフォーカスされているか、またはアクティブなウィンドウであると決してみなさないでく� さい。

オーバーライド:

setVisible、クラスComponent

パラメータ:

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

falseの� �合は、このWindow、そのサブコンポーネント、所有されるすべての子を� します。 #setVisible(true)を呼び出すと、Windowとそのサブコンポーネントをふたたび可視状態にできます。

関連� �目:

• Component.isDisplayable()
• Component.setVisible(boolean)
• toFront()
• dispose()
• setAutoRequestFocus(boolean)
• isFocusableWindow()

show

@Deprecated public void show()

非推奨。

JDKバージョン1.5で、setVisible(boolean)に置き換えられています。

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

オーバーライド:

show、クラスComponent

関連� �目:

• Component.isDisplayable()
• toFront()

hide

@Deprecated public void hide()

非推奨。

JDKバージョン1.5で、setVisible(boolean)に置き換えられています。

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

オーバーライド:

hide、クラスComponent

関連� �目:

• show()
• dispose()

dispose

public void dispose()

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

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

ノート: Java仮想マシン(VM)内で最後の表示可能なウィンドウが� �棄されると、VMが終了することがあります。 詳細は、「AWTのスレッドの問題」を参照してく� さい。

関連� �目:

• Component.isDisplayable()
• pack()
• show()

toFront

public void toFront()

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

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

開発者は、このウィンドウがWINDOW_GAINED_FOCUSまたはWINDOW_ACTIVATEDイベントを受け取るまで、このウィンドウがフォーカスされているか、またはアクティブなウィンドウであると決してみなさないでく� さい。 最上位のウィンドウがフォーカスされたウィンドウであるプラットフォー� では、ま� フォーカスされていない� �合は、このメソッドは、次の条件下ではほとんどの� �合、このウィンドウをフォーカスします。

• ウィンドウがisFocusableWindow()メソッドで概説されている要件を満たしている。
• ウィンドウのautoRequestFocusプロパティの値がtrueである。
• このウィンドウがフォーカスを取得することが、ネイティブのウィンドウ処理システ� で許可されている。

スタックされる� �が通常、フォーカスされたウィンドウに影響を与えないプラットフォー� では、このメソッドはおそらく、フォーカスされたアクティブなウィンドウを変更されないままにします。

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

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

関連� �目:

• toBack()
• setAutoRequestFocus(boolean)
• isFocusableWindow()

toBack

public void toBack()

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

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

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

関連� �目:

• toFront()

getToolkit

public Toolkit getToolkit()

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

オーバーライド:

getToolkit、クラスComponent

戻り値:

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

関連� �目:

• Toolkit
• Toolkit.getDefaultToolkit()
• Component.getToolkit()

getWarningString

@Deprecated(since="24", forRemoval=true) public final String getWarningString()

削除予定のため非推奨: このAPI要� は、将来のバージョンで削除される可能性があります。

JDK 24以降

このウィンドウで表示される警告文字列を返します。

警告文字列は適用できなくなったため、このメソッドは常にnullを戻し、将来のリリースで削除される可能性があります。

戻り値:

null

getLocale

public Locale getLocale()

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

オーバーライド:

getLocale、クラスComponent

戻り値:

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

導入されたバージョン:

1.1

関連� �目:

• Locale

getInputContext

public InputContext getInputContext()

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

オーバーライド:

getInputContext、クラスComponent

戻り値:

このコンポーネントによって使用される入力コンテキスト。コンテキストを判定できない� �合はnull

導入されたバージョン:

1.2

関連� �目:

• Component.getInputContext()

setCursor

public void setCursor(Cursor cursor)

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

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

オーバーライド:

setCursor、クラスComponent

パラメータ:

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

導入されたバージョン:

1.1

関連� �目:

• Component.getCursor()
• Cursor

getOwner

public Window getOwner()

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

戻り値:

このウィンドウの所有者

導入されたバージョン:

1.2

getOwnedWindows

public Window[] getOwnedWindows()

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

戻り値:

すべての所有ウィンドウの配列

導入されたバージョン:

1.2

getWindows

public static Window[] getWindows()

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

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

戻り値:

アプリケーションによって作成されたすべてのWindowの配列

導入されたバージョン:

1.6

関連� �目:

• Frame.getFrames()
• getOwnerlessWindows()

getOwnerlessWindows

public static Window[] getOwnerlessWindows()

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

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

戻り値:

このアプリケーションによって作成されたすべてのownerless Windowの配列

導入されたバージョン:

1.6

関連� �目:

• Frame.getFrames()
• getWindows()

setModalExclusionType

public void setModalExclusionType(Dialog.ModalExclusionType exclusionType)

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

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

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

パラメータ:

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

導入されたバージョン:

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のスレッドの問題」を参照してく� さい。

パラメータ:

l - ウィンドウ・リスナー

関連� �目:

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

addWindowStateListener

public void addWindowStateListener(WindowStateListener l)

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

AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してく� さい。

パラメータ:

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

導入されたバージョン:

1.4

関連� �目:

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

addWindowFocusListener

public void addWindowFocusListener(WindowFocusListener l)

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

AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してく� さい。

パラメータ:

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

導入されたバージョン:

1.4

関連� �目:

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

removeWindowListener

public void removeWindowListener(WindowListener l)

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

AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してく� さい。

パラメータ:

l - ウィンドウ・リスナー

関連� �目:

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

removeWindowStateListener

public void removeWindowStateListener(WindowStateListener l)

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

AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してく� さい。

パラメータ:

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

導入されたバージョン:

1.4

関連� �目:

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

removeWindowFocusListener

public void removeWindowFocusListener(WindowFocusListener l)

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

AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してく� さい。

パラメータ:

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

このようなリスナーがない� �合は空の配列を返します。

オーバーライド:

getListeners、クラスContainer

型パラメータ:

T - リスナーの型

パラメータ:

listenerType - 要求されるリスナーの型。java.util.EventListenerの子孫のインタフェースを指定してく� さい

戻り値:

このウィンドウにFooListenerとして登録されているすべてのオブジェクトの配列。そのようなリスナーが登録されていない� �合は空の配列

スロー:

ClassCastException - listenerTypeで、java.util.EventListenerを実装するクラスまたはインタフェースが指定されなかった� �合

NullPointerException - listenerTypeがnullである� �合

導入されたバージョン:

1.3

関連� �目:

• getWindowListeners()

processEvent

protected void processEvent(AWTEvent e)

このウィンドウのイベントを処理します。 イベントがWindowEventである� �合、processWindowEventメソッドを呼び出します。そうでない� �合は、スーパー・クラスのprocessEventを呼び出します。

イベント・パラメータがnullである� �合は、動作が未指定のため、例外が発生する可能性があります。

オーバーライド:

processEvent、クラスContainer

パラメータ:

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)

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

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

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

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

ウィンドウでこのメソッドが値falseで呼び出される� �合、最前面状態は標準に設定されます。 また、最上位ウィンドウのZ軸� �に、プラットフォー� に依存する未指定の変更が発生しますが、他の最前面ウィンドウは最前面の位置に保持されます。 標準状態のウィンドウでこのメソッドを値falseで呼び出しても、何も起こりません。

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

パラメータ:

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

導入されたバージョン:

1.5

関連� �目:

• isAlwaysOnTop()
• toFront()
• toBack()
• isAlwaysOnTopSupported()
• getToolkit()
• Toolkit.isAlwaysOnTopSupported()

isAlwaysOnTopSupported

public boolean isAlwaysOnTopSupported()

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

戻り値:

このウィンドウおよびこのウィンドウのツールキットで最前面モードがサポートされている� �合はtrue、それ以外の� �合はfalse

導入されたバージョン:

1.6

関連� �目:

• setAlwaysOnTop(boolean)
• getToolkit()
• 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のデフォルトのトラバーサル・キーが返されます。

オーバーライド:

getFocusTraversalKeys、クラスContainer

パラメータ:

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<? extends java.awt.AWTKeyStroke>)
• 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は常にフォーカス・トラバーサル・サイクルのルートであるため、何も操作は行われません。 渡された値は無視されます。

オーバーライド:

setFocusCycleRoot、クラスContainer

パラメータ:

focusCycleRoot - この値は無視される

導入されたバージョン:

1.4

関連� �目:

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

isFocusCycleRoot

public final boolean isFocusCycleRoot()

すべてのウィンドウはフォーカス・トラバーサル・サイクルのルートである必要があるため、常にtrueを返します。

オーバーライド:

isFocusCycleRoot、クラスContainer

戻り値:

true

導入されたバージョン:

1.4

関連� �目:

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

getFocusCycleRootAncestor

public final Container getFocusCycleRootAncestor()

ウィンドウに上位コンポーネントがないため、常にnullを返します。これらは、Component階層の最上位を表します。

オーバーライド:

getFocusCycleRootAncestor、クラスComponent

戻り値:

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で概説されているほかの要件を満たす� �合に、このウィンドウがフォーカスされたウィンドウになれるかどうかを返します。 このメソッドが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状態が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)

setAutoRequestFocus

public void setAutoRequestFocus(boolean autoRequestFocus)

このウィンドウが、そのあとに表示されるフォーカス(setVisible(true)の呼出しを使用)、または前面に移動されるフォーカス(toFront()の呼出しを使用)のどちらを受信するかを設定します。

setVisible(true)は間接的に呼び出されることがあります(ウィンドウのオーナーが表示されたためにウィンドウが表示される� �合など)。toFront()も間接的に呼び出されることがあります(すでに可視状態のウィンドウに対してsetVisible(true)が呼び出された� �合など)。 そのような� �合もすべて、このプロパティが効果を持ちます。

このプロパティの値は、所有されたウィンドウには継承されません。

パラメータ:

autoRequestFocus - あとで表示されたときまたは前面に移動されたときに、このウィンドウがフォーカスされるかどうか

導入されたバージョン:

1.7

関連� �目:

• isAutoRequestFocus()
• isFocusableWindow()
• setVisible(boolean)
• toFront()

isAutoRequestFocus

public boolean isAutoRequestFocus()

このウィンドウが、そのあとに表示されるフォーカス(setVisible(true)の呼出しを使用)、または前面に移動されるフォーカス(toFront()の呼出しを使用)のどちらを受信するかを返します。

デフォルトでは、ウィンドウのautoRequestFocus値はtrueになります。

戻り値:

autoRequestFocus値

導入されたバージョン:

1.7

関連� �目:

• setAutoRequestFocus(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の� �合、例外はスローされず、何も処理は行われません。

オーバーライド:

addPropertyChangeListener、クラスContainer

パラメータ:

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の� �合、例外はスローされず、何も処理は行われません。

オーバーライド:

addPropertyChangeListener、クラスContainer

パラメータ:

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

listener - 追� されるPropertyChangeListener

関連� �目:

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

isValidateRoot

public boolean isValidateRoot()

このコンテナが有効なルートであるかどうかを示します。

Windowオブジェクトは有効なルートであるため、それらはこのメソッドをオーバーライドしてtrueを返します。

オーバーライド:

isValidateRoot、クラスContainer

戻り値:

true

導入されたバージョン:

1.7

関連� �目:

• Container.isValidateRoot()

postEvent

@Deprecated public boolean postEvent(Event e)

非推奨。

JDKバージョン1.1で、dispatchEvent(AWTEvent)に置き換えられています。

インタフェース: MenuContainerからコピーされた説明

イベントをリスナーに投稿します。

定義:

postEvent、インタフェースMenuContainer

オーバーライド:

postEvent、クラスComponent

パラメータ:

e - ディスパッチするイベント

戻り値:

イベントを投稿した結果

isShowing

public boolean isShowing()

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

オーバーライド:

isShowing、クラスComponent

戻り値:

コンポーネントが表示されている� �合はtrue、それ以外の� �合はfalse

関連� �目:

• Component.setVisible(boolean)

applyResourceBundle

@Deprecated public void applyResourceBundle(ResourceBundle rb)

非推奨。

J2SE 1.4から、Component.applyComponentOrientationに置き換えられました。

パラメータ:

rb - リソース・バンドル

applyResourceBundle

@Deprecated public void applyResourceBundle(String rbName)

非推奨。

J2SE 1.4から、Component.applyComponentOrientationに置き換えられました。

パラメータ:

rbName - リソース名

setType

public void setType(Window.Type type)

ウィンドウのタイプを設定します。 このメソッドは、ウィンドウが表示可能でない時に� け呼び出すことができます。

パラメータ:

type - ウィンドウのタイプ

スロー:

IllegalComponentStateException - ウィンドウが表示可能な� �合。

IllegalArgumentException - タイプがnullの� �合

導入されたバージョン:

1.7

関連� �目:

• Component.isDisplayable()
• getType()

getType

public Window.Type getType()

ウィンドウのタイプを返します。

戻り値:

ウィンドウの型

導入されたバージョン:

1.7

関連� �目:

• setType(java.awt.Window.Type)

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

定義:

getAccessibleContext、インタフェースAccessible

オーバーライド:

getAccessibleContext、クラスComponent

戻り値:

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

導入されたバージョン:

1.3

setLocationRelativeTo

public void setLocationRelativeTo(Component c)

次のシナリオに応じて、指定されたコンポーネントを基準にしたウィンドウの位置を設定します。

後述のターゲット・スクリーンとは、setLocationRelativeToメソッドの呼出しのあとにウィンドウが配置される画面のことです。

• コンポーネントがnullの� �合、またはこのコンポーネントに関連付けられた GraphicsConfigurationがnullの� �合、ウィンドウは画面の中央に配置されます。 中心点はGraphicsEnvironment.getCenterPointメソッドで取得できます。
• コンポーネントがnullではないが現在表示されていない� �合、このコンポーネントに関連付けられた GraphicsConfigurationで定義されているターゲット・スクリーンの中央にウィンドウが配置されます。
• コンポーネントがnullではなく、画面に表示されている� �合、ウィンドウの中心がコンポーネントの中心と一致するようにウィンドウが配置されます。

ウィンドウを画面間で移動することが画面の構成で許可されていない� �合、ウィンドウは単に上記の条件に従って配置され、そのGraphicsConfigurationは変更されません。

ノート: ウィンドウの下辺が画面の外にある� �合、ウィンドウは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より小さい� �合、またはcapsが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

関連� �目:

• 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の呼出しによって指定された最小サイズより小さい� �合、自動的に大きくなります。

このメソッドは、幾何学的図形に関連するデータを変更します。 そのため、Windowオブジェクトがデスクトップ設定に厳密に対応する方法で配置およびサイズ設定されるように、ネイティブ・ウィンドウ管理システ� はこのような要求を無視するか、または要求されたデータを変更する可能性があります。

オーバーライド:

setBounds、クラスComponent

パラメータ:

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

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

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

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

導入されたバージョン:

1.6

関連� �目:

• Component.getBounds()
• setLocation(int, int)
• 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の呼出しによって指定された最小サイズより小さい� �合、自動的に大きくなります。

このメソッドは、幾何学的図形に関連するデータを変更します。 そのため、Windowオブジェクトがデスクトップ設定に厳密に対応する方法で配置およびサイズ設定されるように、ネイティブ・ウィンドウ管理システ� はこのような要求を無視するか、または要求されたデータを変更する可能性があります。

オーバーライド:

setBounds、クラスComponent

パラメータ:

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

導入されたバージョン:

1.6

関連� �目:

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

getOpacity

public float getOpacity()

ウィンドウの不透明性を返します。

戻り値:

ウィンドウの不透明性

導入されたバージョン:

1.7

関連� �目:

• setOpacity(float)
• GraphicsDevice.WindowTranslucency

setOpacity

public void setOpacity(float opacity)

ウィンドウの不透明性を設定します。

不透明性の値は[0..1]の範囲にあります。 不透明性レベルを0に設定すると、このウィンドウ上のマウス・イベント処理が無効になる可能性があることに注意してく� さい。 これは、プラットフォー� 依存の動作です。

1.0fより小さい不透明性の値を設定するには、次の条件が満たされる必要があります。

• 基本となるシステ� でTRANSLUCENTの半透明性がサポートされている必要がある
• ウィンドウが非装飾に設定されている必要がある(Frame.setUndecorated(boolean)およびDialog.setUndecorated(boolean)を参照してく� さい)
• ウィンドウがフル・スクリーン・モードであってはいけない(GraphicsDevice.setFullScreenWindow(Window)を参照してく� さい)

要求された不透明性の値が1.0fより小さく、かつ上のいずれかの条件が満たされていない� �合、ウィンドウの不透明性は変更されず、IllegalComponentStateExceptionがスローされます。

個々のピクセルの半透明性レベルは、その色のアルファ成分(setBackground(Color)を参照してく� さい)や、このウィンドウの現在の形状(setShape(Shape)を参照してく� さい)によっても影響を受ける可能性があります。

パラメータ:

opacity - ウィンドウに設定する不透明性レベル

スロー:

IllegalArgumentException - 不透明性が[0..1]の範囲外の� �合

IllegalComponentStateException - ウィンドウが装飾され、不透明性が1.0fより小さい� �合

IllegalComponentStateException - ウィンドウがフル・スクリーン・モードで、不透明性が1.0fより小さい� �合

UnsupportedOperationException - GraphicsDevice.WindowTranslucency#TRANSLUCENT TRANSLUCENT半透明性がサポートされておらず、不透明性が1.0fより小さい� �合

導入されたバージョン:

1.7

関連� �目:

• getOpacity()
• setBackground(Color)
• setShape(Shape)
• Frame.isUndecorated()
• Dialog.isUndecorated()
• GraphicsDevice.WindowTranslucency
• GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)

getShape

public Shape getShape()

ウィンドウの形状を返します。 このメソッドで返される値は、その前にsetShape(shape)で設定された値とは異なる� �合がありますが、同じ形状を表すことは保証されています。

戻り値:

ウィンドウの形状。ウィンドウの形状が指定されていない� �合はnull

導入されたバージョン:

1.7

関連� �目:

• setShape(Shape)
• GraphicsDevice.WindowTranslucency

setShape

public void setShape(Shape shape)

ウィンドウの形状を設定します。

形状を設定すると、ウィンドウの一部が切り離されます。 表示およびクリック可能のままになるのは、特定のShapeに属している部分� けです。 shape引数がnullである� �合、このメソッドはデフォルトの形状を復元し、ほとんどのプラットフォー� 上でウィンドウを矩形にします。

null以外の形状を設定するには、次の条件が満たされる必要があります。

• 基本となるシステ� でPERPIXEL_TRANSPARENTの半透明性がサポートされている必要がある
• ウィンドウが非装飾に設定されている必要がある(Frame.setUndecorated(boolean)およびDialog.setUndecorated(boolean)を参照してく� さい)
• ウィンドウがフル・スクリーン・モードであってはいけない(GraphicsDevice.setFullScreenWindow(Window)を参照してく� さい)

要求された形状がnullでなく、かつ上のいずれかの条件が満たされていない� �合、このウィンドウの形状は変更されず、UnsupportedOperationExceptionまたは IllegalComponentStateExceptionのどちらかがスローされます。

個々のピクセルの半透明性レベルは、その色のアルファ成分(setBackground(Color)を参照してく� さい)や、不透明性の値(setOpacity(float)を参照してく� さい)によっても影響を受ける可能性があります。 詳細は、GraphicsDevice.WindowTranslucencyを参照してく� さい。

パラメータ:

shape - ウィンドウに設定する形状

スロー:

IllegalComponentStateException - shapeが nullではなく、ウィンドウが装飾されている� �合

IllegalComponentStateException - shapeが nullではなく、ウィンドウがフル・スクリーン・モードの� �合

UnsupportedOperationException - shapeが nullではなく、PERPIXEL_TRANSPARENT半透明性がサポートされていない� �合

導入されたバージョン:

1.7

関連� �目:

• getShape()
• setBackground(Color)
• setOpacity(float)
• Frame.isUndecorated()
• Dialog.isUndecorated()
• GraphicsDevice.WindowTranslucency
• GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)

getBackground

public Color getBackground()

このウィンドウの背景色を取得します。

返された色のアルファ成分は、ウィンドウが不透明でない(ピクセルごとに半透明)モードかどうかを示しています。

オーバーライド:

getBackground、クラスComponent

戻り値:

このコンポーネントのバックグラウンド・カラー

関連� �目:

• setBackground(Color)
• isOpaque()
• GraphicsDevice.WindowTranslucency

setBackground

public void setBackground(Color bgColor)

このウィンドウの背景色を設定します。

ウィンドウ管理システ� がPERPIXEL_TRANSLUCENTの半透明性をサポートしている� �合は、特定の背景色のアルファ成分がこのウィンドウの動作モードに影響を与える可能性があります。これは、このウィンドウが不透明(アルファが1.0fに等しい)、またはピクセルごとに半透明(アルファが1.0fより小さい)のどちらである必要があるかを示します。 特定の背景色がnullである� �合、ウィンドウは完全に不透明であると見なされます。

このウィンドウのピクセルごとの透明度モードを有効にするには、次のすべての条件が満たされる必要があります。

• このウィンドウが配置されているグラフィックス・デバイスでPERPIXEL_TRANSLUCENTの半透明性がサポートされている必要がある
• ウィンドウが非装飾に設定されている必要がある(Frame.setUndecorated(boolean)およびDialog.setUndecorated(boolean)を参照してく� さい)
• ウィンドウがフル・スクリーン・モードであってはいけない(GraphicsDevice.setFullScreenWindow(Window)を参照してく� さい)

要求された背景色のアルファ成分が1.0fより小さく、かつ上のいずれかの条件が満たされていない� �合、このウィンドウの背景色は変更されず、特定の背景色のアルファ成分がこのウィンドウの動作モード影響を与えることはなく、UnsupportedOperationExceptionまたは IllegalComponentStateExceptionのどちらかがスローされます。

ウィンドウがピクセルごとに半透明である� �合、描画サブシステ� は個々のピクセルのアルファ値に従います。 ピクセルが0に等しいアルファ色成分でペイントされた� �合、そのピクセルは視覚的に透明になります。 ピクセルのアルファが1.0fに等しい� �合、そのピクセルは完全に不透明です。 アルファ色成分の中間値によって、ピクセルは半透明になります。 このモードでは、ウィンドウのバックグラウンドは、特定の背景色のアルファ値でペイントされます。 このメソッドの引数のアルファ値が0に等しい� �合、バックグラウンドはまったくペイントされません。

特定のピクセルの半透明性の実際のレベルは、ウィンドウの不透明性(setOpacity(float)を参照してく� さい)や、このウィンドウの現在の形状(setShape(Shape)を参照してく� さい)によっても異なります。

ピクセルを0のアルファ値でペイントすると、このピクセル上のマウス・イベント処理が無効になる可能性があることに注意してく� さい。 これは、プラットフォー� 依存の動作です。 マウス・イベントが特定のピクセルにディスパッチされないようにするには、そのピクセルをウィンドウの形状から除外する必要があります。

ピクセルごとの半透明性モードを有効にすると、ネイティブ・プラット・フォー� の要件のために、このウィンドウのグラフィックス構成が変更される可能性があります。

オーバーライド:

setBackground、クラスComponent

パラメータ:

bgColor - このウィンドウの背景色になる色。

スロー:

IllegalComponentStateException - 指定されたバックグラウンド・カラーのアルファ値が1.0fより小さく、ウィンドウが装飾されている� �合

IllegalComponentStateException - 指定されたバックグラウンド・カラーのアルファ値が1.0fより小さく、ウィンドウがフル・スクリーン・モードの� �合

UnsupportedOperationException - 指定されたバックグラウンド・カラーのアルファ値が1.0fより小さく、PERPIXEL_TRANSLUCENT半透明性がサポートされていない� �合

関連� �目:

• getBackground()
• isOpaque()
• setOpacity(float)
• setShape(Shape)
• Frame.isUndecorated()
• Dialog.isUndecorated()
• GraphicsDevice.WindowTranslucency
• GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)
• GraphicsConfiguration.isTranslucencyCapable()

isOpaque

public boolean isOpaque()

ウィンドウが現在不透明かどうかを示します。

ウィンドウのバックグラウンド・カラーがnullではなく、そのカラーのアルファ成分が1.0fより小さい� �合、このメソッドはfalseを返します。 それ以外の� �合、このメソッドはtrueを返します。

オーバーライド:

isOpaque、クラスComponent

戻り値:

ウィンドウが不透明な� �合はtrue、そうでない� �合はfalse

導入されたバージョン:

1.7

関連� �目:

• getBackground()
• setBackground(Color)

paint

public void paint(Graphics g)

コンテナをペイントします。 このコンテナの子コンポーネントであるすべての軽量コンポーネントへペイントを転送します。 このメソッドが再実装される� �合、軽量コンポーネントが正しく描画されるようにsuper.paint(g)を呼び出すようにしてく� さい。 子コンポーネントがgの現在のクリッピング設定によって全体的にクリップされる� �合、paint()はその子には転送されません。

オーバーライド:

paint、クラスContainer

パラメータ:

g - 指定されたGraphicsウィンドウ

導入されたバージョン:

1.7

関連� �目:

• Component.update(Graphics)