java.awt

Class Window

public class Window extends Container implements Accessible

This class represents a top-level window with no decorations.
Nested Class Summary
protected classWindow.AccessibleAWTWindow
Constructor Summary
Window(Frame owner)
Initializes a new instance of Window with the specified parent.
Window(Window owner)
Initializes a new instance of Window with the specified parent.
Window(Window owner, GraphicsConfiguration gc)
Initializes a new instance of Window with the specified parent.
Method Summary
voidaddNotify()
Creates the native peer for this window.
voidaddWindowFocusListener(WindowFocusListener wfl)
Adds the specified listener to this window.
voidaddWindowListener(WindowListener listener)
Adds the specified listener to the list of WindowListeners that will receive events for this window.
voidaddWindowStateListener(WindowStateListener wsl)
Adds the specified listener to this window.
voidapplyResourceBundle(ResourceBundle rb)
voidapplyResourceBundle(String rbName)
voidcreateBufferStrategy(int numBuffers)
Creates a buffering strategy that manages how this window is repainted.
voidcreateBufferStrategy(int numBuffers, BufferCapabilities caps)
Creates a buffering strategy that manages how this window is repainted.
voiddispose()
Destroys any resources associated with this window.
AccessibleContextgetAccessibleContext()
Gets the AccessibleContext associated with this Window.
BufferStrategygetBufferStrategy()
Returns the buffer strategy used by the window.
booleangetFocusableWindowState()
Returns the value of the focusableWindowState property.
ContainergetFocusCycleRootAncestor()
Returns the root container that owns the focus cycle where this component resides.
ComponentgetFocusOwner()
Returns the child window that has focus if this window is active.
GraphicsConfigurationgetGraphicsConfiguration()
Get graphics configuration.
<T extends EventListener> T[]getListeners(Class<T> listenerType)
Returns an array of all the objects currently registered as FooListeners upon this Window.
LocalegetLocale()
Returns the locale that this window is configured for.
ComponentgetMostRecentFocusOwner()
Returns the child component of this window that would receive focus if this window were to become focused.
Window[]getOwnedWindows()
WindowgetOwner()
ToolkitgetToolkit()
Returns the toolkit used to create this window.
StringgetWarningString()
Returns the warning string that will be displayed if this window is popped up by an unsecure applet or application.
WindowFocusListener[]getWindowFocusListeners()
Returns an array of all the window focus listeners registered on this window.
WindowListener[]getWindowListeners()
Returns an array of all the window listeners registered on this window.
WindowStateListener[]getWindowStateListeners()
Returns an array of all the window state listeners registered on this window.
booleanisActive()
Identifies if this window is active.
booleanisAlwaysOnTop()
Returns whether the Windows is an always-on-top window, meaning whether the window can be obscured by other windows or not.
booleanisFocusableWindow()
Returns whether this Window can get the focus or not.
booleanisFocusCycleRoot()
Check whether this Container is a focus cycle root.
booleanisFocused()
Identifies if this window is focused.
booleanisShowing()
Tests whether or not this window is visible on the screen.
voidpack()
Relays out this window's child components at their preferred size.
booleanpostEvent(Event e)
Post a Java 1.0 event to the event queue.
protected voidprocessEvent(AWTEvent evt)
Processes the specified event for this window.
protected voidprocessWindowEvent(WindowEvent evt)
Dispatches this event to any listeners that are listening for WindowEvents on this window.
protected voidprocessWindowFocusEvent(WindowEvent event)
protected voidprocessWindowStateEvent(WindowEvent event)
voidremoveWindowFocusListener(WindowFocusListener wfl)
Removes the specified listener from this window.
voidremoveWindowListener(WindowListener listener)
Removes the specified listener from the list of WindowListeners that will receive events for this window.
voidremoveWindowStateListener(WindowStateListener wsl)
Removes the specified listener from this window.
voidsetAlwaysOnTop(boolean alwaysOnTop)
Sets the always-on-top state of this window (if supported).
voidsetCursor(Cursor cursor)
Sets the cursor for this window to the specifiec cursor.
voidsetFocusableWindowState(boolean focusableWindowState)
Sets the value of the focusableWindowState property.
voidsetFocusCycleRoot(boolean focusCycleRoot)
Set whether or not this Container is the root of a focus traversal cycle.
voidsetLocationRelativeTo(Component c)
voidtoBack()
Sends this window to the back so that all other windows display in front of it.
voidtoFront()
Brings this window to the front so that it displays in front of any other windows.

Constructor Detail

Window

public Window(Frame owner)
Initializes a new instance of Window with the specified parent. The window will initially be invisible.

Parameters: owner The owning Frame of this window.

Throws: IllegalArgumentException If the owner's GraphicsConfiguration is not from a screen device, or if owner is null; this exception is always thrown when GraphicsEnvironment.isHeadless returns true.

Window

public Window(Window owner)
Initializes a new instance of Window with the specified parent. The window will initially be invisible.

Throws: IllegalArgumentException If the owner's GraphicsConfiguration is not from a screen device, or if owner is null; this exception is always thrown when GraphicsEnvironment.isHeadless returns true.

Since: 1.2

Window

public Window(Window owner, GraphicsConfiguration gc)
Initializes a new instance of Window with the specified parent. The window will initially be invisible.

Throws: IllegalArgumentException If owner is null or if gc is not from a screen device; this exception is always thrown when GraphicsEnvironment.isHeadless returns true.

Since: 1.3

Method Detail

addNotify

public void addNotify()
Creates the native peer for this window.

addWindowFocusListener

public void addWindowFocusListener(WindowFocusListener wfl)
Adds the specified listener to this window.

addWindowListener

public void addWindowListener(WindowListener listener)
Adds the specified listener to the list of WindowListeners that will receive events for this window.

Parameters: listener The WindowListener to add.

addWindowStateListener

public void addWindowStateListener(WindowStateListener wsl)
Adds the specified listener to this window.

Since: 1.4

applyResourceBundle

public void applyResourceBundle(ResourceBundle rb)

Deprecated: replaced by Component.applyComponentOrientation.

Since: 1.2

applyResourceBundle

public void applyResourceBundle(String rbName)

Deprecated:

Since: 1.2

createBufferStrategy

public void createBufferStrategy(int numBuffers)
Creates a buffering strategy that manages how this window is repainted. This method attempts to create the optimum strategy based on the desired number of buffers. Hardware or software acceleration may be used. createBufferStrategy attempts different levels of optimization, but guarantees that some strategy with the requested number of buffers will be created even if it is not optimal. First it attempts to create a page flipping strategy, then an accelerated blitting strategy, then an unaccelerated blitting strategy. Calling this method causes any existing buffer strategy to be destroyed.

Parameters: numBuffers the number of buffers in this strategy

Throws: IllegalArgumentException if requested number of buffers is less than one IllegalStateException if this window is not displayable

Since: 1.4

createBufferStrategy

public void createBufferStrategy(int numBuffers, BufferCapabilities caps)
Creates a buffering strategy that manages how this window is repainted. This method attempts to create a strategy based on the specified capabilities and throws an exception if the requested strategy is not supported. Calling this method causes any existing buffer strategy to be destroyed.

Parameters: numBuffers the number of buffers in this strategy caps the requested buffering capabilities

Throws: AWTException if the requested capabilities are not supported IllegalArgumentException if requested number of buffers is less than one or if caps is null

Since: 1.4

dispose

public void dispose()
Destroys any resources associated with this window. This includes all components in the window and all owned top-level windows.

getAccessibleContext

public AccessibleContext getAccessibleContext()
Gets the AccessibleContext associated with this Window. The context is created, if necessary.

Returns: the associated context

getBufferStrategy

public BufferStrategy getBufferStrategy()
Returns the buffer strategy used by the window.

Returns: the buffer strategy.

Since: 1.4

getFocusableWindowState

public boolean getFocusableWindowState()
Returns the value of the focusableWindowState property.

Since: 1.4

getFocusCycleRootAncestor

public final Container getFocusCycleRootAncestor()
Returns the root container that owns the focus cycle where this component resides. Windows have no ancestors and this method returns always null.

Returns: Always null.

Since: 1.4

getFocusOwner

public Component getFocusOwner()
Returns the child window that has focus if this window is active. This method returns null if this window is not active or no children have focus.

Returns: The component that has focus, or null if no component has focus.

getGraphicsConfiguration

public GraphicsConfiguration getGraphicsConfiguration()
Get graphics configuration. The implementation for Window will not ask any parent containers, since Window is a toplevel window and not actually embedded in the parent component.

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)
Returns an array of all the objects currently registered as FooListeners upon this Window. FooListeners are registered using the addFooListener method.

Throws: ClassCastException If listenerType doesn't specify a class or interface that implements java.util.EventListener.

Since: 1.3

getLocale

public Locale getLocale()
Returns the locale that this window is configured for.

Returns: The locale this window is configured for.

getMostRecentFocusOwner

public Component getMostRecentFocusOwner()
Returns the child component of this window that would receive focus if this window were to become focused. If the window already has the top-level focus, then this method returns the same component as getFocusOwner. If no child component has requested focus within the window, then the initial focus owner is returned. If this is a non-focusable window, this method returns null.

Returns: the child component of this window that most recently had the focus, or null

Since: 1.4

getOwnedWindows

public Window[] getOwnedWindows()

Since: 1.2

getOwner

public Window getOwner()

getToolkit

public Toolkit getToolkit()
Returns the toolkit used to create this window.

Returns: The toolkit used to create this window.

UNKNOWN: Unlike Component.getToolkit, this implementation always returns the value of Toolkit.getDefaultToolkit().

getWarningString

public final String getWarningString()
Returns the warning string that will be displayed if this window is popped up by an unsecure applet or application.

Returns: The unsecure window warning message.

getWindowFocusListeners

public WindowFocusListener[] getWindowFocusListeners()
Returns an array of all the window focus listeners registered on this window.

Since: 1.4

getWindowListeners

public WindowListener[] getWindowListeners()
Returns an array of all the window listeners registered on this window.

Since: 1.4

getWindowStateListeners

public WindowStateListener[] getWindowStateListeners()
Returns an array of all the window state listeners registered on this window.

Since: 1.4

isActive

public boolean isActive()
Identifies if this window is active. The active window is a Frame or Dialog that has focus or owns the active window.

Returns: true if active, else false.

Since: 1.4

isAlwaysOnTop

public final boolean isAlwaysOnTop()
Returns whether the Windows is an always-on-top window, meaning whether the window can be obscured by other windows or not.

Returns: true if the windows is always-on-top, false otherwise.

Since: 1.5

isFocusableWindow

public final boolean isFocusableWindow()
Returns whether this Window can get the focus or not.

Since: 1.4

isFocusCycleRoot

public final boolean isFocusCycleRoot()
Check whether this Container is a focus cycle root. Returns always true as Windows are the root of the focus cycle.

Returns: Always true.

Since: 1.4

isFocused

public boolean isFocused()
Identifies if this window is focused. A window is focused if it is the focus owner or it contains the focus owner.

Returns: true if focused, else false.

Since: 1.4

isShowing

public boolean isShowing()
Tests whether or not this window is visible on the screen. In contrast to the normal behaviour of Container, which is that a container is showing if its parent is visible and showing, a Window is even showing, if its parent (i.e. an invisible Frame) is not showing.

Returns: true if this window is visible, false otherwise.

pack

public void pack()
Relays out this window's child components at their preferred size.

UNKNOWN: pack() doesn't appear to be called internally by show(), so we duplicate some of the functionality.

postEvent

public boolean postEvent(Event e)

Deprecated:

Post a Java 1.0 event to the event queue.

Parameters: e The event to post.

processEvent

protected void processEvent(AWTEvent evt)
Processes the specified event for this window. If the event is an instance of WindowEvent, then processWindowEvent() is called to process the event, otherwise the superclass version of this method is invoked.

Parameters: evt The event to process.

processWindowEvent

protected void processWindowEvent(WindowEvent evt)
Dispatches this event to any listeners that are listening for WindowEvents on this window. This method only gets invoked if it is enabled via enableEvents() or if a listener has been added.

Parameters: evt The event to process.

processWindowFocusEvent

protected void processWindowFocusEvent(WindowEvent event)

processWindowStateEvent

protected void processWindowStateEvent(WindowEvent event)

Since: 1.4

removeWindowFocusListener

public void removeWindowFocusListener(WindowFocusListener wfl)
Removes the specified listener from this window.

removeWindowListener

public void removeWindowListener(WindowListener listener)
Removes the specified listener from the list of WindowListeners that will receive events for this window.

Parameters: listener The WindowListener to remove.

removeWindowStateListener

public void removeWindowStateListener(WindowStateListener wsl)
Removes the specified listener from this window.

Since: 1.4

setAlwaysOnTop

public final void setAlwaysOnTop(boolean alwaysOnTop)
Sets the always-on-top state of this window (if supported). Setting a window to always-on-top means it will not be obscured by any other windows (with the exception of other always-on-top windows). Not all platforms may support this. If an window's always-on-top status is changed to false, the window will remain at the front but not be anchored there. Calling toBack() on an always-on-top window will change its always-on-top status to false.

Since: 1.5

setCursor

public void setCursor(Cursor cursor)
Sets the cursor for this window to the specifiec cursor.

Parameters: cursor The new cursor for this window.

setFocusableWindowState

public void setFocusableWindowState(boolean focusableWindowState)
Sets the value of the focusableWindowState property.

Since: 1.4

setFocusCycleRoot

public final void setFocusCycleRoot(boolean focusCycleRoot)
Set whether or not this Container is the root of a focus traversal cycle. Windows are the root of the focus cycle and therefore this method does nothing.

Parameters: focusCycleRoot ignored.

Since: 1.4

setLocationRelativeTo

public void setLocationRelativeTo(Component c)

toBack

public void toBack()
Sends this window to the back so that all other windows display in front of it. If the window is set to be always-on-top, this will remove its always-on-top status.

toFront

public void toFront()
Brings this window to the front so that it displays in front of any other windows.