/*
* @(#)Window.java 1.210 05/03/03
*
* Copyright 2005 Sun Microsystems, Inc. All rights reserved.
* SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
*/
package java.awt;
import java.applet.Applet;
import java.awt.peer.WindowPeer;
import java.awt.peer.ComponentPeer;
import java.awt.event.*;
import java.awt.image.BufferStrategy;
import java.util.Vector;
import java.util.Locale;
import java.util.EventListener;
import java.util.Set;
import java.io.Serializable;
import java.io.ObjectOutputStream;
import java.io.ObjectInputStream;
import java.io.IOException;
import java.io.OptionalDataException;
import java.awt.im.InputContext;
import java.util.ResourceBundle;
import java.lang.ref.WeakReference;
import java.lang.reflect.InvocationTargetException;
import java.security.AccessController;
import java.security.PrivilegedAction;
import javax.accessibility.*;
import java.beans.PropertyChangeListener;
import sun.security.action.GetPropertyAction;
import sun.security.util.SecurityConstants;
import sun.awt.DebugHelper;
/**
* A Window
object is a top-level window with no borders and no
* menubar.
* The default layout for a window is BorderLayout
.
*
* A window must have either a frame, dialog, or another window defined as its * owner when it's constructed. *
* In a multi-screen environment, you can create a Window
* on a different screen device by constructing the Window
* with {@link #Window(Window, GraphicsConfiguration)}. The
* GraphicsConfiguration
object is one of the
* GraphicsConfiguration
objects of the target screen device.
*
* In a virtual device multi-screen environment in which the desktop * area could span multiple physical screen devices, the bounds of all * configurations are relative to the virtual device coordinate system. * The origin of the virtual-coordinate system is at the upper left-hand * corner of the primary physical screen. Depending on the location of * the primary screen in the virtual device, negative coordinates are * possible, as shown in the following figure. *
* *
* In such an environment, when calling setLocation
,
* you must pass a virtual coordinate to this method. Similarly,
* calling getLocationOnScreen
on a Window
returns
* virtual device coordinates. Call the getBounds
method
* of a GraphicsConfiguration
to find its origin in the virtual
* coordinate system.
*
* The following code sets the location of a Window
* at (10, 10) relative to the origin of the physical screen
* of the corresponding GraphicsConfiguration
. If the
* bounds of the GraphicsConfiguration
is not taken
* into account, the Window
location would be set
* at (10, 10) relative to the virtual-coordinate system and would appear
* on the primary physical screen, which might be different from the
* physical screen of the specified GraphicsConfiguration
.
*
*
* Window w = new Window(Window owner, GraphicsConfiguration gc); * Rectangle bounds = gc.getBounds(); * w.setLocation(10 + bounds.x, 10 + bounds.y); ** *
* Note: the location and size of top-level windows (including
* Window
s, Frame
s, and Dialog
s)
* are under the control of the desktop's window management system.
* Calls to setLocation
, setSize
, and
* setBounds
are requests (not directives) which are
* forwarded to the window management system. Every effort will be
* made to honor such requests. However, in some cases the window
* management system may ignore such requests, or modify the requested
* geometry in order to place and size the Window
in a way
* that more closely matches the desktop settings.
*
* Due to the asynchronous nature of native event handling, the results
* returned by getBounds
, getLocation
,
* getLocationOnScreen
, and getSize
might not
* reflect the actual geometry of the Window on screen until the last
* request has been processed. During the processing of subsequent
* requests these values might change accordingly while the window
* management system fulfills the requests.
*
*
* Windows are capable of generating the following WindowEvents:
* WindowOpened, WindowClosed, WindowGainedFocus, WindowLostFocus.
*
* @version 1.210, 03/03/05
* @author Sami Shaio
* @author Arthur van Hoff
* @see WindowEvent
* @see #addWindowListener
* @see java.awt.BorderLayout
* @since JDK1.0
*/
public class Window extends Container implements Accessible {
/**
* This represents the warning message that is
* to be displayed in a non secure window. ie :
* a window that has a security manager installed for
* which calling SecurityManager.checkTopLevelWindow()
* is false. This message can be displayed anywhere in
* the window.
*
* @serial
* @see #getWarningString
*/
String warningString;
/**
* Holds the reference to the component which last had focus in this window
* before it lost focus.
*/
private transient Component temporaryLostComponent;
static boolean systemSyncLWRequests = false;
boolean syncLWRequests = false;
transient boolean beforeFirstShow = true;
static final int OPENED = 0x01;
/**
* An Integer value representing the Window State.
*
* @serial
* @since 1.2
* @see #show
*/
int state;
/**
* A boolean value representing Window always-on-top state
* @since 1.5
* @serial
* @see #setAlwaysOnTop
* @see #isAlwaysOnTop
*/
private boolean alwaysOnTop;
/**
* A vector containing all the windows this
* window currently owns.
* @since 1.2
* @see #getOwnedWindows
*/
transient Vector ownedWindowList = new Vector();
private transient WeakReference weakThis;
private transient boolean showWithParent = false;
transient WindowListener windowListener;
transient WindowStateListener windowStateListener;
transient WindowFocusListener windowFocusListener;
transient InputContext inputContext;
private transient Object inputContextLock = new Object();
/**
* Unused. Maintained for serialization backward-compatibility.
*
* @serial
* @since 1.2
*/
private FocusManager focusMgr;
/**
* Indicates whether this Window can become the focused Window.
*
* @serial
* @see #getFocusableWindowState
* @see #setFocusableWindowState
* @since 1.4
*/
private boolean focusableWindowState = true;
private static final String base = "win";
private static int nameCounter = 0;
/*
* JDK 1.1 serialVersionUID
*/
private static final long serialVersionUID = 4497834738069338734L;
private static final DebugHelper dbg = DebugHelper.create(Window.class);
private static final boolean locationByPlatformProp;
/**
* Indicates whether this Window is modal excluded, i. e. is not
* blocked by modal dialogs
* @since 1.5
*/
private transient boolean modalExcluded = false;
static {
/* ensure that the necessary native libraries are loaded */
Toolkit.loadLibraries();
if (!GraphicsEnvironment.isHeadless()) {
initIDs();
}
String s = (String) java.security.AccessController.doPrivileged(
new GetPropertyAction("java.awt.syncLWRequests"));
systemSyncLWRequests = (s != null && s.equals("true"));
s = (String) java.security.AccessController.doPrivileged(
new GetPropertyAction("java.awt.Window.locationByPlatform"));
locationByPlatformProp = (s != null && s.equals("true"));
}
/**
* Initialize JNI field and method IDs for fields that may be
accessed from C.
*/
private static native void initIDs();
/**
* Constructs a new window in default size with the
* specified GraphicsConfiguration
.
*
* If there is a security manager, this method first calls
* the security manager's checkTopLevelWindow
* method with this
* as its argument to determine whether or not the window
* must be displayed with a warning banner.
* @param gc the GraphicsConfiguration
* of the target screen device. If gc
is
* null
, the system default
* GraphicsConfiguration
is assumed.
* @exception IllegalArgumentException if gc
* is not from a screen device. This exception is always
* thrown when GraphicsEnvironment.isHeadless() returns true.
* @see java.awt.GraphicsEnvironment#isHeadless
* @see java.lang.SecurityManager#checkTopLevelWindow
*/
Window(GraphicsConfiguration gc) {
init(gc);
}
private void init(GraphicsConfiguration gc) {
if (GraphicsEnvironment.isHeadless()) {
throw new IllegalArgumentException("headless environment");
}
syncLWRequests = systemSyncLWRequests;
setWarningString();
this.cursor = Cursor.getPredefinedCursor(Cursor.DEFAULT_CURSOR);
this.visible = false;
if (gc == null) {
this.graphicsConfig =
GraphicsEnvironment.getLocalGraphicsEnvironment().
getDefaultScreenDevice().getDefaultConfiguration();
} else {
this.graphicsConfig = gc;
}
if (graphicsConfig.getDevice().getType() !=
GraphicsDevice.TYPE_RASTER_SCREEN) {
throw new IllegalArgumentException("not a screen device");
}
setLayout(new BorderLayout());
/* offset the initial location with the original of the screen */
/* and any insets */
Rectangle screenBounds = graphicsConfig.getBounds();
Insets screenInsets = getToolkit().getScreenInsets(graphicsConfig);
int x = getX() + screenBounds.x + screenInsets.left;
int y = getY() + screenBounds.y + screenInsets.top;
if (x != this.x || y != this.y) {
setLocation(x, y);
/* reset after setLocation */
setLocationByPlatform(locationByPlatformProp);
}
}
/**
* Constructs a new window in the default size.
*
*
First, if there is a security manager, its
* checkTopLevelWindow
* method is called with this
* as its argument
* to see if it's ok to display the window without a warning banner.
* If the default implementation of checkTopLevelWindow
* is used (that is, that method is not overriden), then this results in
* a call to the security manager's checkPermission
method
* with an AWTPermission("showWindowWithoutWarningBanner")
* permission. It that method raises a SecurityException,
* checkTopLevelWindow
returns false, otherwise it
* returns true. If it returns false, a warning banner is created.
*
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true
* @see java.awt.GraphicsEnvironment#isHeadless
* @see java.lang.SecurityManager#checkTopLevelWindow
*/
Window() throws HeadlessException {
GraphicsEnvironment.checkHeadless();
init((GraphicsConfiguration)null);
}
/**
* Constructs a new invisible window with the specified
* Frame
as its owner. The Window will not be focusable
* unless its owner is showing on the screen.
*
* If there is a security manager, this method first calls
* the security manager's checkTopLevelWindow
* method with this
* as its argument to determine whether or not the window
* must be displayed with a warning banner.
*
* @param owner the Frame
to act as owner
* @exception IllegalArgumentException if the owner
's
* GraphicsConfiguration
is not from a screen device
* @exception java.lang.IllegalArgumentException if
* owner
is null
; this exception
* is always thrown when GraphicsEnvironment.isHeadless
* returns true
* @see java.awt.GraphicsEnvironment#isHeadless
* @see java.lang.SecurityManager#checkTopLevelWindow
* @see #isShowing
*/
public Window(Frame owner) {
this(owner == null ? (GraphicsConfiguration)null :
owner.getGraphicsConfiguration());
ownedInit(owner);
}
/**
* Constructs a new invisible window with the specified
* Window
as its owner. The Window will not be focusable
* unless its nearest owning Frame or Dialog is showing on the screen.
*
* If there is a security manager, this method first calls
* the security manager's checkTopLevelWindow
* method with this
* as its argument to determine whether or not the window
* must be displayed with a warning banner.
*
* @param owner the Window
to act as owner
* @exception IllegalArgumentException if the owner
's
* GraphicsConfiguration
is not from a screen device
* @exception java.lang.IllegalArgumentException if owner
* is null
. This exception is always thrown
* when GraphicsEnvironment.isHeadless() returns true.
* @see java.awt.GraphicsEnvironment#isHeadless
* @see java.lang.SecurityManager#checkTopLevelWindow
* @see #isShowing
* @since 1.2
*/
public Window(Window owner) {
this(owner == null ? (GraphicsConfiguration)null :
owner.getGraphicsConfiguration());
ownedInit(owner);
}
/**
* Constructs a new invisible window with the specified
* window as its owner and a
* GraphicsConfiguration
of a screen device. The Window will
* not be focusable unless its nearest owning Frame or Dialog is showing on
* the screen.
*
* If there is a security manager, this method first calls
* the security manager's checkTopLevelWindow
* method with this
* as its argument to determine whether or not the window
* must be displayed with a warning banner.
*
* @param owner the window to act as owner
* @param gc the GraphicsConfiguration
* of the target screen device; if gc
is
* null
, the system default
* GraphicsConfiguration
is assumed
* @throws IllegalArgumentException if
* owner
is null
* @throws IllegalArgumentException if gc
is not from
* a screen device; this exception is always thrown when
* GraphicsEnvironment.isHeadless
returns
* true
* @see java.awt.GraphicsEnvironment#isHeadless
* @see java.lang.SecurityManager#checkTopLevelWindow
* @see GraphicsConfiguration#getBounds
* @see #isShowing
* @since 1.3
*/
public Window(Window owner, GraphicsConfiguration gc) {
this(gc);
ownedInit(owner);
}
private void ownedInit(Window owner) {
if (owner == null) {
throw new IllegalArgumentException("null owner window");
}
this.parent = owner;
this.weakThis = new WeakReference(this);
owner.addOwnedWindow(weakThis);
modalExcluded = owner.modalExcluded;
}
/**
* Disposes of the input methods and context, and removes
* this Window from the GUI hierarchy. Subclasses that override
* this method should call super.finalize().
*/
protected void finalize() throws Throwable {
// We have to remove the (hard) reference to weakThis in the
// parent's ownedWindowList, otherwise the WeakReference
// instance that points to this Window will never get garbage
// collected.
if (parent != null) {
((Window)parent).removeOwnedWindow(weakThis);
}
super.finalize();
}
/**
* Construct a name for this component. Called by getName() when the
* name is null.
*/
String constructComponentName() {
synchronized (getClass()) {
return base + nameCounter++;
}
}
/**
* Makes this Window displayable by creating the connection to its
* native screen resource.
* This method is called internally by the toolkit and should
* not be called directly by programs.
* @see Component#isDisplayable
* @see Container#removeNotify
* @since JDK1.0
*/
public void addNotify() {
synchronized (getTreeLock()) {
Container parent = this.parent;
if (parent != null && parent.getPeer() == null) {
parent.addNotify();
}
if (peer == null)
peer = getToolkit().createWindow(this);
super.addNotify();
}
}
/**
* Causes this Window to be sized to fit the preferred size
* and layouts of its subcomponents. If the window and/or its owner
* are not yet displayable, both are made displayable before
* calculating the preferred size. The Window will be validated
* after the preferredSize is calculated.
* @see Component#isDisplayable
*/
public void pack() {
Container parent = this.parent;
if (parent != null && parent.getPeer() == null) {
parent.addNotify();
}
if (peer == null) {
addNotify();
}
Dimension newSize = getPreferredSize();
if (peer != null) {
setClientSize(newSize.width, newSize.height);
}
if(beforeFirstShow) {
isPacked = true;
}
validate();
}
void setClientSize(int w, int h) {
synchronized (getTreeLock()) {
setBoundsOp(ComponentPeer.SET_CLIENT_SIZE);
setBounds(x, y, w, h);
}
}
/**
* @deprecated As of JDK 5, replaced by
* {@link Component#setVisible(boolean) Component.setVisible(boolean)}.
*/
@Deprecated
public void show() {
if (peer == null) {
addNotify();
}
validate();
if (visible) {
toFront();
} else {
beforeFirstShow = false;
super.show();
locationByPlatform = false;
for (int i = 0; i < ownedWindowList.size(); i++) {
Window child = (Window) (((WeakReference)
(ownedWindowList.elementAt(i))).get());
if ((child != null) && child.showWithParent) {
child.show();
child.showWithParent = false;
} // endif
} // endfor
}
// If first time shown, generate WindowOpened event
if ((state & OPENED) == 0) {
postWindowEvent(WindowEvent.WINDOW_OPENED);
state |= OPENED;
}
}
synchronized void postWindowEvent(int id) {
if (windowListener != null
|| (eventMask & AWTEvent.WINDOW_EVENT_MASK) != 0
|| Toolkit.enabledOnToolkit(AWTEvent.WINDOW_EVENT_MASK)) {
WindowEvent e = new WindowEvent(this, id);
Toolkit.getEventQueue().postEvent(e);
}
}
/**
* @deprecated As of JDK 5, replaced by
* {@link Component#setVisible(boolean) Component.setVisible(boolean)}.
*/
@Deprecated
public void hide() {
synchronized(ownedWindowList) {
for (int i = 0; i < ownedWindowList.size(); i++) {
Window child = (Window) (((WeakReference)
(ownedWindowList.elementAt(i))).get());
if ((child != null) && child.visible) {
child.hide();
child.showWithParent = true;
}
}
}
super.hide();
}
final void clearMostRecentFocusOwnerOnHide() {
/* do nothing */
}
/**
* Releases all of the native screen resources used by this
* Window
, its subcomponents, and all of its owned
* children. That is, the resources for these Component
s
* will be destroyed, any memory they consume will be returned to the
* OS, and they will be marked as undisplayable.
*
* The Window
and its subcomponents can be made displayable
* again by rebuilding the native resources with a subsequent call to
* pack
or show
. The states of the recreated
* Window
and its subcomponents will be identical to the
* states of these objects at the point where the Window
* was disposed (not accounting for additional modifications between
* those actions).
*
* Note: When the last displayable window * within the Java virtual machine (VM) is disposed of, the VM may * terminate. See * AWT Threading Issues for more information. * @see Component#isDisplayable * @see #pack * @see #show */ public void dispose() { doDispose(); } /* * Fix for 4872170. * If dispose() is called on parent then its children have to be disposed as well * as reported in javadoc. So we need to implement this functionality even if a * child overrides dispose() in a wrong way without calling super.dispose(). */ void disposeImpl() { dispose(); if (getPeer() != null) { doDispose(); } } void doDispose() { class DisposeAction implements Runnable { public void run() { Object[] ownedWindowArray; synchronized(ownedWindowList) { ownedWindowArray = new Object[ownedWindowList.size()]; ownedWindowList.copyInto(ownedWindowArray); } for (int i = 0; i < ownedWindowArray.length; i++) { Window child = (Window) (((WeakReference) (ownedWindowArray[i])).get()); if (child != null) { child.disposeImpl(); } } hide(); beforeFirstShow = true; removeNotify(); synchronized (inputContextLock) { if (inputContext != null) { inputContext.dispose(); inputContext = null; } } clearCurrentFocusCycleRootOnHide(); } } DisposeAction action = new DisposeAction(); if (EventQueue.isDispatchThread()) { action.run(); } else { try { EventQueue.invokeAndWait(action); } catch (InterruptedException e) { System.err.println("Disposal was interrupted:"); e.printStackTrace(); } catch (InvocationTargetException e) { System.err.println("Exception during disposal:"); e.printStackTrace(); } } // Execute outside the Runnable because postWindowEvent is // synchronized on (this). We don't need to synchronize the call // on the EventQueue anyways. postWindowEvent(WindowEvent.WINDOW_CLOSED); } /* * Should only be called while holding the tree lock. * It's overridden here because parent == owner in Window, * and we shouldn't adjust counter on owner */ void adjustListeningChildrenOnParent(long mask, int num) { } // Should only be called while holding tree lock void adjustDecendantsOnParent(int num) { // do nothing since parent == owner and we shouldn't // ajust counter on owner } /** * If this Window is visible, brings this Window to the front and may make * it the focused Window. *
* Places this Window at the top of the stacking order and shows it in * front of any other Windows in this VM. No action will take place if this * Window is not visible. Some platforms do not allow Windows which own * other Windows to appear on top of those owned Windows. Some platforms * may not permit this VM to place its Windows above windows of native * applications, or Windows of other VMs. This permission may depend on * whether a Window in this VM is already focused. Every attempt will be * made to move this Window as high as possible in the stacking order; * however, developers should not assume that this method will move this * Window above all other windows in every situation. *
* Because of variations in native windowing systems, no guarantees about * changes to the focused and active Windows can be made. Developers must * never assume that this Window is the focused or active Window until this * Window receives a WINDOW_GAINED_FOCUS or WINDOW_ACTIVATED event. On * platforms where the top-most window is the focused window, this method * will probably focus this Window, if it is not already focused. On * platforms where the stacking order does not typically affect the focused * window, this method will probably leave the focused and active * Windows unchanged. *
* If this method causes this Window to be focused, and this Window is a * Frame or a Dialog, it will also become activated. If this Window is * focused, but it is not a Frame or a Dialog, then the first Frame or * Dialog that is an owner of this Window will be activated. * * @see #toBack */ public void toFront() { if (visible) { WindowPeer peer = (WindowPeer)this.peer; if (peer != null) { peer.toFront(); } } } /** * If this Window is visible, sends this Window to the back and may cause * it to lose focus or activation if it is the focused or active Window. *
* Places this Window at the bottom of the stacking order and shows it * behind any other Windows in this VM. No action will take place is this * Window is not visible. Some platforms do not allow Windows which are * owned by other Windows to appear below their owners. Every attempt will * be made to move this Window as low as possible in the stacking order; * however, developers should not assume that this method will move this * Window below all other windows in every situation. *
* Because of variations in native windowing systems, no guarantees about
* changes to the focused and active Windows can be made. Developers must
* never assume that this Window is no longer the focused or active Window
* until this Window receives a WINDOW_LOST_FOCUS or WINDOW_DEACTIVATED
* event. On platforms where the top-most window is the focused window,
* this method will probably cause this Window to lose focus. In
* that case, the next highest, focusable Window in this VM will receive
* focus. On platforms where the stacking order does not typically affect
* the focused window, this method will probably leave the focused
* and active Windows unchanged.
*
* @see #toFront
*/
public void toBack() {
if (visible) {
WindowPeer peer = (WindowPeer)this.peer;
if (peer != null) {
peer.toBack();
}
}
}
/**
* Returns the toolkit of this frame.
* @return the toolkit of this window.
* @see Toolkit
* @see Toolkit#getDefaultToolkit
* @see Component#getToolkit
*/
public Toolkit getToolkit() {
return Toolkit.getDefaultToolkit();
}
/**
* Gets the warning string that is displayed with this window.
* If this window is insecure, the warning string is displayed
* somewhere in the visible area of the window. A window is
* insecure if there is a security manager, and the security
* manager's checkTopLevelWindow
method returns
* false
when this window is passed to it as an
* argument.
*
* If the window is secure, then getWarningString
* returns null
. If the window is insecure, this
* method checks for the system property
* awt.appletWarning
* and returns the string value of that property.
* @return the warning string for this window.
* @see java.lang.SecurityManager#checkTopLevelWindow(java.lang.Object)
*/
public final String getWarningString() {
return warningString;
}
private void setWarningString() {
warningString = null;
SecurityManager sm = System.getSecurityManager();
if (sm != null) {
if (!sm.checkTopLevelWindow(this)) {
// make sure the privileged action is only
// for getting the property! We don't want the
// above checkTopLevelWindow call to always succeed!
warningString = (String) AccessController.doPrivileged(
new GetPropertyAction("awt.appletWarning",
"Java Applet Window"));
}
}
}
/**
* Gets the Locale
object that is associated
* with this window, if the locale has been set.
* If no locale has been set, then the default locale
* is returned.
* @return the locale that is set for this window.
* @see java.util.Locale
* @since JDK1.1
*/
public Locale getLocale() {
if (this.locale == null) {
return Locale.getDefault();
}
return this.locale;
}
/**
* Gets the input context for this window. A window always has an input context,
* which is shared by subcomponents unless they create and set their own.
* @see Component#getInputContext
* @since 1.2
*/
public InputContext getInputContext() {
if (inputContext == null) {
synchronized (inputContextLock) {
if (inputContext == null) {
inputContext = InputContext.getInstance();
}
}
}
return inputContext;
}
/**
* Set the cursor image to a specified cursor.
* @param cursor One of the constants defined
* by the Cursor
class. If this parameter is null
* then the cursor for this window will be set to the type
* Cursor.DEFAULT_CURSOR.
* @see Component#getCursor
* @see Cursor
* @since JDK1.1
*/
public void setCursor(Cursor cursor) {
if (cursor == null) {
cursor = Cursor.getPredefinedCursor(Cursor.DEFAULT_CURSOR);
}
super.setCursor(cursor);
}
/**
* Returns the owner of this window.
* @since 1.2
*/
public Window getOwner() {
return (Window)parent;
}
/**
* Return an array containing all the windows this
* window currently owns.
* @since 1.2
*/
public Window[] getOwnedWindows() {
Window realCopy[];
synchronized(ownedWindowList) {
// Recall that ownedWindowList is actually a Vector of
// WeakReferences and calling get() on one of these references
// may return null. Make two arrays-- one the size of the
// Vector (fullCopy with size fullSize), and one the size of
// all non-null get()s (realCopy with size realSize).
int fullSize = ownedWindowList.size();
int realSize = 0;
Window fullCopy[] = new Window[fullSize];
for (int i = 0; i < fullSize; i++) {
fullCopy[realSize] = (Window) (((WeakReference)
(ownedWindowList.elementAt(i))).get());
if (fullCopy[realSize] != null) {
realSize++;
}
}
if (fullSize != realSize) {
realCopy = new Window[realSize];
System.arraycopy(fullCopy, 0, realCopy, 0, realSize);
} else {
realCopy = fullCopy;
}
}
return realCopy;
}
/**
* Adds the specified window listener to receive window events from
* this window.
* If l is null, no exception is thrown and no action is performed.
*
* @param l the window listener
* @see #removeWindowListener
* @see #getWindowListeners
*/
public synchronized void addWindowListener(WindowListener l) {
if (l == null) {
return;
}
newEventsOnly = true;
windowListener = AWTEventMulticaster.add(windowListener, l);
}
/**
* Adds the specified window state listener to receive window
* events from this window. If l
is null,
* no exception is thrown and no action is performed.
*
* @param l the window state listener
* @see #removeWindowStateListener
* @see #getWindowStateListeners
* @since 1.4
*/
public synchronized void addWindowStateListener(WindowStateListener l) {
if (l == null) {
return;
}
windowStateListener = AWTEventMulticaster.add(windowStateListener, l);
newEventsOnly = true;
}
/**
* Adds the specified window focus listener to receive window events
* from this window.
* If l is null, no exception is thrown and no action is performed.
*
* @param l the window focus listener
* @see #removeWindowFocusListener
* @see #getWindowFocusListeners
*/
public synchronized void addWindowFocusListener(WindowFocusListener l) {
if (l == null) {
return;
}
windowFocusListener = AWTEventMulticaster.add(windowFocusListener, l);
newEventsOnly = true;
}
/**
* Removes the specified window listener so that it no longer
* receives window events from this window.
* If l is null, no exception is thrown and no action is performed.
*
* @param l the window listener
* @see #addWindowListener
* @see #getWindowListeners
*/
public synchronized void removeWindowListener(WindowListener l) {
if (l == null) {
return;
}
windowListener = AWTEventMulticaster.remove(windowListener, l);
}
/**
* Removes the specified window state listener so that it no
* longer receives window events from this window. If
* l
is null
, no exception is thrown and
* no action is performed.
*
* @param l the window state listener
* @see #addWindowStateListener
* @see #getWindowStateListeners
* @since 1.4
*/
public synchronized void removeWindowStateListener(WindowStateListener l) {
if (l == null) {
return;
}
windowStateListener = AWTEventMulticaster.remove(windowStateListener, l);
}
/**
* Removes the specified window focus listener so that it no longer
* receives window events from this window.
* If l is null, no exception is thrown and no action is performed.
*
* @param l the window focus listener
* @see #addWindowFocusListener
* @see #getWindowFocusListeners
*/
public synchronized void removeWindowFocusListener(WindowFocusListener l) {
if (l == null) {
return;
}
windowFocusListener = AWTEventMulticaster.remove(windowFocusListener, l);
}
/**
* Returns an array of all the window listeners
* registered on this window.
*
* @return all of this window's WindowListener
s
* or an empty array if no window
* listeners are currently registered
*
* @see #addWindowListener
* @see #removeWindowListener
* @since 1.4
*/
public synchronized WindowListener[] getWindowListeners() {
return (WindowListener[])(getListeners(WindowListener.class));
}
/**
* Returns an array of all the window focus listeners
* registered on this window.
*
* @return all of this window's WindowFocusListener
s
* or an empty array if no window focus
* listeners are currently registered
*
* @see #addWindowFocusListener
* @see #removeWindowFocusListener
* @since 1.4
*/
public synchronized WindowFocusListener[] getWindowFocusListeners() {
return (WindowFocusListener[])(getListeners(WindowFocusListener.class));
}
/**
* Returns an array of all the window state listeners
* registered on this window.
*
* @return all of this window's WindowStateListener
s
* or an empty array if no window state
* listeners are currently registered
*
* @see #addWindowStateListener
* @see #removeWindowStateListener
* @since 1.4
*/
public synchronized WindowStateListener[] getWindowStateListeners() {
return (WindowStateListener[])(getListeners(WindowStateListener.class));
}
/**
* Returns an array of all the objects currently registered
* as FooListener
s
* upon this Window
.
* FooListener
s are registered using the
* addFooListener
method.
*
*
*
* You can specify the listenerType
argument
* with a class literal, such as
* FooListener.class
.
* For example, you can query a
* Window
w
* for its window listeners with the following code:
*
*
WindowListener[] wls = (WindowListener[])(w.getListeners(WindowListener.class));* * If no such listeners exist, this method returns an empty array. * * @param listenerType the type of listeners requested; this parameter * should specify an interface that descends from *
java.util.EventListener
* @return an array of all objects registered as
* FooListener
s on this window,
* or an empty array if no such
* listeners have been added
* @exception ClassCastException if listenerType
* doesn't specify a class or interface that implements
* java.util.EventListener
*
* @see #getWindowListeners
* @since 1.3
*/
public WindowEvent
, it invokes the
* processWindowEvent
method, else it invokes its
* superclass's processEvent
.
* Note that if the event parameter is null
* the behavior is unspecified and may result in an
* exception.
*
* @param e the event
*/
protected void processEvent(AWTEvent e) {
if (e instanceof WindowEvent) {
switch (e.getID()) {
case WindowEvent.WINDOW_OPENED:
case WindowEvent.WINDOW_CLOSING:
case WindowEvent.WINDOW_CLOSED:
case WindowEvent.WINDOW_ICONIFIED:
case WindowEvent.WINDOW_DEICONIFIED:
case WindowEvent.WINDOW_ACTIVATED:
case WindowEvent.WINDOW_DEACTIVATED:
processWindowEvent((WindowEvent)e);
break;
case WindowEvent.WINDOW_GAINED_FOCUS:
case WindowEvent.WINDOW_LOST_FOCUS:
processWindowFocusEvent((WindowEvent)e);
break;
case WindowEvent.WINDOW_STATE_CHANGED:
processWindowStateEvent((WindowEvent)e);
default:
break;
}
return;
}
super.processEvent(e);
}
/**
* Processes window events occurring on this window by
* dispatching them to any registered WindowListener objects.
* NOTE: This method will not be called unless window events
* are enabled for this component; this happens when one of the
* following occurs:
*
addWindowListener
* enableEvents
* Note that if the event parameter is null
* the behavior is unspecified and may result in an
* exception.
*
* @param e the window event
* @see Component#enableEvents
*/
protected void processWindowEvent(WindowEvent e) {
WindowListener listener = windowListener;
if (listener != null) {
switch(e.getID()) {
case WindowEvent.WINDOW_OPENED:
listener.windowOpened(e);
break;
case WindowEvent.WINDOW_CLOSING:
listener.windowClosing(e);
break;
case WindowEvent.WINDOW_CLOSED:
listener.windowClosed(e);
break;
case WindowEvent.WINDOW_ICONIFIED:
listener.windowIconified(e);
break;
case WindowEvent.WINDOW_DEICONIFIED:
listener.windowDeiconified(e);
break;
case WindowEvent.WINDOW_ACTIVATED:
listener.windowActivated(e);
break;
case WindowEvent.WINDOW_DEACTIVATED:
listener.windowDeactivated(e);
break;
default:
break;
}
}
}
/**
* Processes window focus event occuring on this window by
* dispatching them to any registered WindowFocusListener objects.
* NOTE: this method will not be called unless window focus events
* are enabled for this window. This happens when one of the
* following occurs:
*
addWindowFocusListener
* enableEvents
* Note that if the event parameter is null
* the behavior is unspecified and may result in an
* exception.
*
* @param e the window focus event
* @see Component#enableEvents
*/
protected void processWindowFocusEvent(WindowEvent e) {
WindowFocusListener listener = windowFocusListener;
if (listener != null) {
switch (e.getID()) {
case WindowEvent.WINDOW_GAINED_FOCUS:
listener.windowGainedFocus(e);
break;
case WindowEvent.WINDOW_LOST_FOCUS:
listener.windowLostFocus(e);
break;
default:
break;
}
}
}
/**
* Processes window state event occuring on this window by
* dispatching them to any registered WindowStateListener
* objects.
* NOTE: this method will not be called unless window state events
* are enabled for this window. This happens when one of the
* following occurs:
*
WindowStateListener
is registered via
* addWindowStateListener
* enableEvents
* Note that if the event parameter is null
* the behavior is unspecified and may result in an
* exception.
*
* @param e the window state event
* @see java.awt.Component#enableEvents
* @since 1.4
*/
protected void processWindowStateEvent(WindowEvent e) {
WindowStateListener listener = windowStateListener;
if (listener != null) {
switch (e.getID()) {
case WindowEvent.WINDOW_STATE_CHANGED:
listener.windowStateChanged(e);
break;
default:
break;
}
}
}
/**
* Implements a debugging hook -- checks to see if
* the user has typed control-shift-F1. If so,
* the list of child windows is dumped to System.out
.
* @param e the keyboard event
*/
void preProcessKeyEvent(KeyEvent e) {
// Dump the list of child windows to System.out.
if (e.isActionKey() && e.getKeyCode() == KeyEvent.VK_F1 &&
e.isControlDown() && e.isShiftDown() &&
e.getID() == KeyEvent.KEY_PRESSED) {
list(System.out, 0);
}
}
void postProcessKeyEvent(KeyEvent e) {
// Do nothing
}
/**
* Changes the always-on-top window state. An always-on-top window
* is a window that stays above all other windows except maybe
* other always-on-top windows. If there are several always-on-top
* windows the order in which they stay relative to each other is
* not specified and is platform dependent.
*
* If some other window already is always-on-top then the * relative order between these windows is unspecified (depends on * platform). No window can be brought to be over always-on-top * window except maybe another always-on-top window. *
* All owned windows of an always-on-top window automatically * become always-on-top windows. If a window ceases to be * always-on-top its owned windows cease to be always-on-top. *
When an always-on-top window is sent {@link #toBack toBack}
* its always-on-top state is set to false
.
*
* This method makes the window always-on-top if
* alwaysOnTop
is true
. If the window is
* visible, this includes bringing window toFront
, then
* "sticking" it to the top-most position. If the window is not
* visible it does nothing other than setting the always-on-top
* property. If later the window is shown, it will be always-on-top.
* If the Window is already always-on-top, this call does nothing.
*
* If alwaysOnTop
is false
this
* method changes the state from always-on-top to normal. The window
* remains top-most but its z-order can be changed in the normal way
* as for any other window. Does nothing if this Window is not
* always-on-top. Has no effect on relative z-order of windows if
* there are no other always-on-top windows.
*
* Note: some platforms might not support always-on-top * windows. There is no public API to detect if the platform * supports always-on-top at runtime. *
* If a SecurityManager is installed, the calling thread must be
* granted the AWTPermission "setWindowAlwaysOnTop" in
* order to set the value of this property. If this
* permission is not granted, this method will throw a
* SecurityException, and the current value of the property will
* be left unchanged.
*
* @param alwaysOnTop new value of always-on-top state of the
* window
* @throws SecurityException if the calling thread does not have permission
* to set the value of always-on-top property
* @see #isAlwaysOnTop
* @see #toFront
* @see #toBack
* @see AWTPermission
* @since 1.5
*/
public final void setAlwaysOnTop(boolean alwaysOnTop)
throws SecurityException
{
SecurityManager security = System.getSecurityManager();
if (security != null) {
security.checkPermission(SecurityConstants.SET_WINDOW_ALWAYS_ON_TOP_PERMISSION);
}
boolean oldAlwaysOnTop;
synchronized(this) {
oldAlwaysOnTop = this.alwaysOnTop;
this.alwaysOnTop = alwaysOnTop;
}
if (oldAlwaysOnTop != alwaysOnTop ) {
WindowPeer peer = (WindowPeer)this.peer;
synchronized(getTreeLock()) {
if (peer != null) {
peer.updateAlwaysOnTop();
}
}
firePropertyChange("alwaysOnTop", oldAlwaysOnTop, alwaysOnTop);
}
}
/**
* Returns whether this window is an always-on-top window.
* @return true
, if the window is in always-on-top state,
* false
otherwise
* @see #setAlwaysOnTop
* @since 1.5
*/
public final boolean isAlwaysOnTop() {
return alwaysOnTop;
}
/**
* Returns the child Component of this Window that has focus if this Window
* is focused; returns null otherwise.
*
* @return the child Component with focus, or null if this Window is not
* focused
* @see #getMostRecentFocusOwner
* @see #isFocused
*/
public Component getFocusOwner() {
return (isFocused())
? KeyboardFocusManager.getCurrentKeyboardFocusManager().
getFocusOwner()
: null;
}
/**
* Returns the child Component of this Window that will receive the focus
* when this Window is focused. If this Window is currently focused, this
* method returns the same Component as getFocusOwner()
. If
* this Window is not focused, then the child Component that most recently
* requested focus will be returned. If no child Component has ever
* requested focus, and this is a focusable Window, then this Window's
* initial focusable Component is returned. If no child Component has ever
* requested focus, and this is a non-focusable Window, null is returned.
*
* @return the child Component that will receive focus when this Window is
* focused
* @see #getFocusOwner
* @see #isFocused
* @see #isFocusableWindow
* @since 1.4
*/
public Component getMostRecentFocusOwner() {
if (isFocused()) {
return getFocusOwner();
} else {
Component mostRecent =
KeyboardFocusManager.getMostRecentFocusOwner(this);
if (mostRecent != null) {
return mostRecent;
} else {
return (isFocusableWindow())
? getFocusTraversalPolicy().getInitialComponent(this)
: null;
}
}
}
/**
* Returns whether this Window is active. Only a Frame or a Dialog may be
* active. The native windowing system may denote the active Window or its
* children with special decorations, such as a highlighted title bar. The
* active Window is always either the focused Window, or the first Frame or
* Dialog that is an owner of the focused Window.
*
* @return whether this is the active Window.
* @see #isFocused
* @since 1.4
*/
public boolean isActive() {
return (KeyboardFocusManager.getCurrentKeyboardFocusManager().
getActiveWindow() == this);
}
/**
* Returns whether this Window is focused. If there exists a focus owner,
* the focused Window is the Window that is, or contains, that focus owner.
* If there is no focus owner, then no Window is focused.
*
* If the focused Window is a Frame or a Dialog it is also the active
* Window. Otherwise, the active Window is the first Frame or Dialog that
* is an owner of the focused Window.
*
* @return whether this is the focused Window.
* @see #isActive
* @since 1.4
*/
public boolean isFocused() {
return (KeyboardFocusManager.getCurrentKeyboardFocusManager().
getGlobalFocusedWindow() == this);
}
/**
* Gets a focus traversal key for this Window. (See
* setFocusTraversalKeys
for a full description of each key.)
*
* If the traversal key has not been explicitly set for this Window,
* then this Window's parent's traversal key is returned. If the
* traversal key has not been explicitly set for any of this Window's
* ancestors, then the current KeyboardFocusManager's default traversal key
* is returned.
*
* @param id one of KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS,
* KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS,
* KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, or
* KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
* @return the AWTKeyStroke for the specified key
* @see Container#setFocusTraversalKeys
* @see KeyboardFocusManager#FORWARD_TRAVERSAL_KEYS
* @see KeyboardFocusManager#BACKWARD_TRAVERSAL_KEYS
* @see KeyboardFocusManager#UP_CYCLE_TRAVERSAL_KEYS
* @see KeyboardFocusManager#DOWN_CYCLE_TRAVERSAL_KEYS
* @throws IllegalArgumentException if id is not one of
* KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS,
* KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS,
* KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, or
* KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
* @since 1.4
*/
public Set
* By default, all Windows have a focusable Window state of
*
* Setting a Window's focusability state to
* If listener is null, no exception is thrown and no action is performed.
*
* @param listener the PropertyChangeListener to be added
*
* @see Component#removePropertyChangeListener
* @see #addPropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)
*/
public void addPropertyChangeListener(PropertyChangeListener listener) {
super.addPropertyChangeListener(listener);
}
/**
* Adds a PropertyChangeListener to the listener list for a specific
* property. The specified property may be user-defined, or one of the
* following:
*
* If listener is null, no exception is thrown and no action is performed.
*
* @param propertyName one of the property names listed above
* @param listener the PropertyChangeListener to be added
*
* @see #addPropertyChangeListener(java.beans.PropertyChangeListener)
* @see Component#removePropertyChangeListener
*/
public void addPropertyChangeListener(String propertyName,
PropertyChangeListener listener) {
super.addPropertyChangeListener(propertyName, listener);
}
/**
* Dispatches an event to this window or one of its sub components.
* @param e the event
*/
void dispatchEventImpl(AWTEvent e) {
if (e.getID() == ComponentEvent.COMPONENT_RESIZED) {
invalidate();
validate();
}
super.dispatchEventImpl(e);
}
/**
* @deprecated As of JDK version 1.1
* replaced by
* Each time this method is called,
* the existing buffer strategy for this component is discarded.
* @param numBuffers number of buffers to create
* @exception IllegalArgumentException if numBuffers is less than 1.
* @exception IllegalStateException if the component is not displayable
* @see #isDisplayable
* @see #getBufferStrategy
* @since 1.4
*/
public void createBufferStrategy(int numBuffers) {
super.createBufferStrategy(numBuffers);
}
/**
* Creates a new strategy for multi-buffering on this component with the
* required buffer capabilities. This is useful, for example, if only
* accelerated memory or page flipping is desired (as specified by the
* buffer capabilities).
*
* Each time this method
* is called, the existing buffer strategy for this component is discarded.
* @param numBuffers number of buffers to create, including the front buffer
* @param caps the required capabilities for creating the buffer strategy;
* cannot be
* This behavior can also be enabled by setting the System Property
* "java.awt.Window.locationByPlatform" to "true", though calls to this method
* take precedence.
*
* Calls to
* For example, after the following code is executed:
*
* In the following sample:
* true
because all Windows must be roots of a
* focus traversal cycle.
*
* @return true
* @see #setFocusCycleRoot
* @see Container#setFocusTraversalPolicy
* @see Container#getFocusTraversalPolicy
* @since 1.4
*/
public final boolean isFocusCycleRoot() {
return true;
}
/**
* Always returns null
because Windows have no ancestors; they
* represent the top of the Component hierarchy.
*
* @return null
* @see Container#isFocusCycleRoot()
* @since 1.4
*/
public final Container getFocusCycleRootAncestor() {
return null;
}
/**
* Returns whether this Window can become the focused Window, that is,
* whether this Window or any of its subcomponents can become the focus
* owner. For a Frame or Dialog to be focusable, its focusable Window state
* must be set to true
. For a Window which is not a Frame or
* Dialog to be focusable, its focusable Window state must be set to
* true
, its nearest owning Frame or Dialog must be
* showing on the screen, and it must contain at least one Component in
* its focus traversal cycle. If any of these conditions is not met, then
* neither this Window nor any of its subcomponents can become the focus
* owner.
*
* @return true
if this Window can be the focused Window;
* false
otherwise
* @see #getFocusableWindowState
* @see #setFocusableWindowState
* @see #isShowing
* @see Component#isFocusable
* @since 1.4
*/
public final boolean isFocusableWindow() {
// If a Window/Frame/Dialog was made non-focusable, then it is always
// non-focusable.
if (!getFocusableWindowState()) {
return false;
}
// All other tests apply only to Windows.
if (this instanceof Frame || this instanceof Dialog) {
return true;
}
// A Window must have at least one Component in its root focus
// traversal cycle to be focusable.
if (getFocusTraversalPolicy().getDefaultComponent(this) == null) {
return false;
}
// A Window's nearest owning Frame or Dialog must be showing on the
// screen.
for (Window owner = getOwner(); owner != null;
owner = owner.getOwner())
{
if (owner instanceof Frame || owner instanceof Dialog) {
return owner.isShowing();
}
}
return false;
}
/**
* Returns whether this Window can become the focused Window if it meets
* the other requirements outlined in isFocusableWindow
. If
* this method returns false
, then
* isFocusableWindow
will return false
as well.
* If this method returns true
, then
* isFocusableWindow
may return true
or
* false
depending upon the other requirements which must be
* met in order for a Window to be focusable.
* true
.
*
* @return whether this Window can be the focused Window
* @see #isFocusableWindow
* @see #setFocusableWindowState
* @see #isShowing
* @see Component#setFocusable
* @since 1.4
*/
public boolean getFocusableWindowState() {
return focusableWindowState;
}
/**
* Sets whether this Window can become the focused Window if it meets
* the other requirements outlined in isFocusableWindow
. If
* this Window's focusable Window state is set to false
, then
* isFocusableWindow
will return false
. If this
* Window's focusable Window state is set to true
, then
* isFocusableWindow
may return true
or
* false
depending upon the other requirements which must be
* met in order for a Window to be focusable.
* false
is the
* standard mechanism for an application to identify to the AWT a Window
* which will be used as a floating palette or toolbar, and thus should be
* a non-focusable Window.
*
* Setting the focusability state on a visible Window
* can have a delayed effect on some platforms the actual
* change may happen only when the Window
becomes
* hidden and then visible again. To ensure consistent behavior
* across platforms, set the Window
's focusable state
* when the WIndow
is invisible and then show it.
*
* @param focusableWindowState whether this Window can be the focused
* Window
* @see #isFocusableWindow
* @see #getFocusableWindowState
* @see #isShowing
* @see Component#setFocusable
* @since 1.4
*/
public void setFocusableWindowState(boolean focusableWindowState) {
boolean oldFocusableWindowState;
synchronized (this) {
oldFocusableWindowState = this.focusableWindowState;
this.focusableWindowState = focusableWindowState;
}
firePropertyChange("focusableWindowState", oldFocusableWindowState,
focusableWindowState);
if (oldFocusableWindowState && !focusableWindowState && isFocused()) {
for (Window owner = (Window)getParent();
owner != null;
owner = (Window)owner.getParent())
{
Component toFocus =
KeyboardFocusManager.getMostRecentFocusOwner(owner);
if (toFocus != null && toFocus.requestFocus(false)) {
return;
}
}
KeyboardFocusManager.getCurrentKeyboardFocusManager().
clearGlobalFocusOwner();
}
}
/**
* Adds a PropertyChangeListener to the listener list. The listener is
* registered for all bound properties of this class, including the
* following:
*
*
* Note that if this Window is inheriting a bound property, then no
* event will be fired in response to a change in the inherited property.
*
*
* Note that if this Window is inheriting a bound property, then no
* event will be fired in response to a change in the inherited property.
* dispatchEvent(AWTEvent)
.
*/
@Deprecated
public boolean postEvent(Event e) {
if (handleEvent(e)) {
e.consume();
return true;
}
return false;
}
/**
* Checks if this Window is showing on screen.
* @see Component#setVisible
*/
public boolean isShowing() {
return visible;
}
/**
* @deprecated As of J2SE 1.4, replaced by
* {@link Component#applyComponentOrientation Component.applyComponentOrientation}.
*/
@Deprecated
public void applyResourceBundle(ResourceBundle rb) {
applyComponentOrientation(ComponentOrientation.getOrientation(rb));
}
/**
* @deprecated As of J2SE 1.4, replaced by
* {@link Component#applyComponentOrientation Component.applyComponentOrientation}.
*/
@Deprecated
public void applyResourceBundle(String rbName) {
applyResourceBundle(ResourceBundle.getBundle(rbName));
}
/*
* Support for tracking all windows owned by this window
*/
void addOwnedWindow(WeakReference weakWindow) {
if (weakWindow != null) {
synchronized(ownedWindowList) {
// this if statement should really be an assert, but we don't
// have asserts...
if (!ownedWindowList.contains(weakWindow)) {
ownedWindowList.addElement(weakWindow);
}
}
}
}
void removeOwnedWindow(WeakReference weakWindow) {
if (weakWindow != null) {
// synchronized block not required since removeElement is
// already synchronized
ownedWindowList.removeElement(weakWindow);
}
}
void connectOwnedWindow(Window child) {
WeakReference weakChild = new WeakReference(child);
child.weakThis = weakChild;
child.parent = this;
addOwnedWindow(weakChild);
}
/**
* The window serialized data version.
*
* @serial
*/
private int windowSerializedDataVersion = 2;
/**
* Writes default serializable fields to stream. Writes
* a list of serializable WindowListener
s and
* WindowFocusListener
s as optional data.
* Writes a list of child windows as optional data.
*
* @param s the ObjectOutputStream
to write
* @serialData null
terminated sequence of
* 0 or more pairs; the pair consists of a String
* and and Object
; the String
* indicates the type of object and is one of the following:
* windowListenerK
indicating a
* WindowListener
object;
* windowFocusWindowK
indicating a
* WindowFocusListener
object;
* ownedWindowK
indicating a child
* Window
object
*
* @see AWTEventMulticaster#save(java.io.ObjectOutputStream, java.lang.String, java.util.EventListener)
* @see Component#windowListenerK
* @see Component#windowFocusListenerK
* @see Component#ownedWindowK
* @see #readObject(ObjectInputStream)
*/
private void writeObject(ObjectOutputStream s) throws IOException {
synchronized (this) {
// Update old focusMgr fields so that our object stream can be read
// by previous releases
focusMgr = new FocusManager();
focusMgr.focusRoot = this;
focusMgr.focusOwner = getMostRecentFocusOwner();
s.defaultWriteObject();
// Clear fields so that we don't keep extra references around
focusMgr = null;
AWTEventMulticaster.save(s, windowListenerK, windowListener);
AWTEventMulticaster.save(s, windowFocusListenerK, windowFocusListener);
AWTEventMulticaster.save(s, windowStateListenerK, windowStateListener);
}
s.writeObject(null);
synchronized (ownedWindowList) {
for (int i = 0; i < ownedWindowList.size(); i++) {
Window child = (Window) (((WeakReference)
(ownedWindowList.elementAt(i))).get());
if (child != null) {
s.writeObject(ownedWindowK);
s.writeObject(child);
}
}
}
s.writeObject(null);
}
/**
* Reads the ObjectInputStream
and an optional
* list of listeners to receive various events fired by
* the component; also reads a list of
* (possibly null
) child windows.
* Unrecognized keys or values will be ignored.
*
* @param s the ObjectInputStream
to read
* @exception HeadlessException if
* GraphicsEnvironment.isHeadless
returns
* true
* @see java.awt.GraphicsEnvironment#isHeadless
* @see #writeObject
*/
private void readObject(ObjectInputStream s)
throws ClassNotFoundException, IOException, HeadlessException
{
GraphicsEnvironment.checkHeadless();
s.defaultReadObject();
if (windowSerializedDataVersion < 2) {
// Translate old-style focus tracking to new model. For 1.4 and
// later releases, we'll rely on the Window's initial focusable
// Component.
if (focusMgr != null) {
if (focusMgr.focusOwner != null) {
KeyboardFocusManager.
setMostRecentFocusOwner(this, focusMgr.focusOwner);
}
}
// This field is non-transient and relies on default serialization.
// However, the default value is insufficient, so we need to set
// it explicitly for object data streams prior to 1.4.
focusableWindowState = true;
}
// 1.4 doesn't use this field, so just null it out.
focusMgr = null;
ownedWindowList = new Vector();
Object keyOrNull;
while(null != (keyOrNull = s.readObject())) {
String key = ((String)keyOrNull).intern();
if (windowListenerK == key) {
addWindowListener((WindowListener)(s.readObject()));
} else if (windowFocusListenerK == key) {
addWindowFocusListener((WindowFocusListener)(s.readObject()));
} else if (windowStateListenerK == key) {
addWindowStateListener((WindowStateListener)(s.readObject()));
} else // skip value for unrecognized key
s.readObject();
}
try {
while (null != (keyOrNull = s.readObject())) {
String key = ((String)keyOrNull).intern();
if (ownedWindowK == key)
connectOwnedWindow((Window) s.readObject());
else // skip value for unrecognized key
s.readObject();
}
}
catch (OptionalDataException e) {
// 1.1 serialized form
// ownedWindowList will be updated by Frame.readObject
}
setWarningString();
inputContextLock = new Object();
// Deserialized Windows are not yet visible.
visible = false;
}
/*
* --- Accessibility Support ---
*
*/
/**
* Gets the AccessibleContext associated with this Window.
* For windows, the AccessibleContext takes the form of an
* AccessibleAWTWindow.
* A new AccessibleAWTWindow instance is created if necessary.
*
* @return an AccessibleAWTWindow that serves as the
* AccessibleContext of this Window
*/
public AccessibleContext getAccessibleContext() {
if (accessibleContext == null) {
accessibleContext = new AccessibleAWTWindow();
}
return accessibleContext;
}
/**
* This class implements accessibility support for the
* Window
class. It provides an implementation of the
* Java Accessibility API appropriate to window user-interface elements.
*/
protected class AccessibleAWTWindow extends AccessibleAWTContainer
{
/*
* JDK 1.3 serialVersionUID
*/
private static final long serialVersionUID = 4215068635060671780L;
/**
* Get the role of this object.
*
* @return an instance of AccessibleRole describing the role of the
* object
* @see javax.accessibility.AccessibleRole
*/
public AccessibleRole getAccessibleRole() {
return AccessibleRole.WINDOW;
}
/**
* Get the state of this object.
*
* @return an instance of AccessibleStateSet containing the current
* state set of the object
* @see javax.accessibility.AccessibleState
*/
public AccessibleStateSet getAccessibleStateSet() {
AccessibleStateSet states = super.getAccessibleStateSet();
if (getFocusOwner() != null) {
states.add(AccessibleState.ACTIVE);
}
return states;
}
} // inner class AccessibleAWTWindow
/**
* This method returns the GraphicsConfiguration used by this Window.
*/
public GraphicsConfiguration getGraphicsConfiguration() {
//NOTE: for multiscreen, this will need to take into account
//which screen the window is on/mostly on instead of returning the
//default or constructor argument config.
synchronized(getTreeLock()) {
if (graphicsConfig == null && !GraphicsEnvironment.isHeadless()) {
graphicsConfig =
GraphicsEnvironment. getLocalGraphicsEnvironment().
getDefaultScreenDevice().
getDefaultConfiguration();
}
return graphicsConfig;
}
}
/**
* Reset this Window's GraphicsConfiguration to match its peer.
*/
void resetGC() {
if (!GraphicsEnvironment.isHeadless()) {
// use the peer's GC
setGCFromPeer();
// if it's still null, use the default
if (graphicsConfig == null) {
graphicsConfig = GraphicsEnvironment.
getLocalGraphicsEnvironment().
getDefaultScreenDevice().
getDefaultConfiguration();
}
if (dbg.on) {
dbg.println("+ Window.resetGC(): new GC is \n+ " + graphicsConfig + "\n+ this is " + this);
}
}
}
/**
* Sets the location of the window relative to the specified
* component. If the component is not currently showing,
* or c
is null
, the
* window is centered on the screen. If the bottom of the
* component is offscreen, the window is placed to the
* side of the Component
that is closest
* to the center of the screen. So if the
* Component
is on the right part of the
* screen, the Window
is placed to its left,
* and visa versa.
*
* @param c the component in relation to which the window's location
* is determined
* @since 1.4
*/
public void setLocationRelativeTo(Component c) {
Container root=null;
if (c != null) {
if (c instanceof Window || c instanceof Applet) {
root = (Container)c;
} else {
Container parent;
for(parent = c.getParent() ; parent != null ; parent = parent.getParent()) {
if (parent instanceof Window || parent instanceof Applet) {
root = parent;
break;
}
}
}
}
if((c != null && !c.isShowing()) || root == null ||
!root.isShowing()) {
Dimension paneSize = getSize();
Dimension screenSize = getToolkit().getScreenSize();
setLocation((screenSize.width - paneSize.width) / 2,
(screenSize.height - paneSize.height) / 2);
} else {
Dimension invokerSize = c.getSize();
Point invokerScreenLocation = c.getLocationOnScreen();
Rectangle windowBounds = getBounds();
int dx = invokerScreenLocation.x+((invokerSize.width-windowBounds.width)>>1);
int dy = invokerScreenLocation.y+((invokerSize.height - windowBounds.height)>>1);
Rectangle ss = root.getGraphicsConfiguration().getBounds();
// Adjust for bottom edge being offscreen
if (dy+windowBounds.height>ss.height) {
dy = ss.height-windowBounds.height;
if (invokerScreenLocation.x - ss.x + invokerSize.width / 2 <
ss.width / 2) {
dx = invokerScreenLocation.x+invokerSize.width;
}
else {
dx = invokerScreenLocation.x-windowBounds.width;
}
}
// Avoid being placed off the edge of the screen
if (dx+windowBounds.width > ss.x + ss.width) {
dx = ss.x + ss.width - windowBounds.width;
}
if (dx < ss.x) dx = 0;
if (dy < ss.y) dy = 0;
setLocation(dx, dy);
}
}
/**
* Overridden from Component. Top-level Windows should not propagate a
* MouseWheelEvent beyond themselves into their owning Windows.
*/
void deliverMouseWheelToAncestor(MouseWheelEvent e) {}
/**
* Overridden from Component. Top-level Windows don't dispatch to ancestors
*/
boolean dispatchMouseWheelToAncestor(MouseWheelEvent e) {return false;}
/**
* Creates a new strategy for multi-buffering on this component.
* Multi-buffering is useful for rendering performance. This method
* attempts to create the best strategy available with the number of
* buffers supplied. It will always create a BufferStrategy
* with that number of buffers.
* A page-flipping strategy is attempted first, then a blitting strategy
* using accelerated buffers. Finally, an unaccelerated blitting
* strategy is used.
* null
* @exception AWTException if the capabilities supplied could not be
* supported or met; this may happen, for example, if there is not enough
* accelerated memory currently available, or if page flipping is specified
* but not possible.
* @exception IllegalArgumentException if numBuffers is less than 1, or if
* caps is null
* @see #getBufferStrategy
* @since 1.4
*/
public void createBufferStrategy(int numBuffers,
BufferCapabilities caps) throws AWTException {
super.createBufferStrategy(numBuffers, caps);
}
/**
* @return the buffer strategy used by this component
* @see #createBufferStrategy
* @since 1.4
*/
public BufferStrategy getBufferStrategy() {
return super.getBufferStrategy();
}
Component getTemporaryLostComponent() {
return temporaryLostComponent;
}
Component setTemporaryLostComponent(Component component) {
Component previousComp = temporaryLostComponent;
// Check that "component" is an acceptable focus owner and don't store it otherwise
// - or later we will have problems with opposite while handling WINDOW_GAINED_FOCUS
if (component == null
|| (component.isDisplayable() && component.isVisible() && component.isEnabled() && component.isFocusable()))
{
temporaryLostComponent = component;
} else {
temporaryLostComponent = null;
}
return previousComp;
}
/**
* Checks whether this window can contain focus owner.
* Verifies that it is focusable and as container it can container focus owner.
* @since 1.5
*/
boolean canContainFocusOwner(Component focusOwnerCandidate) {
return super.canContainFocusOwner(focusOwnerCandidate) && isFocusableWindow();
}
private boolean locationByPlatform = locationByPlatformProp;
/**
* Sets whether this Window should appear at the default location for the
* native windowing system or at the current location (returned by
* getLocation
) the next time the Window is made visible.
* This behavior resembles a native window shown without programmatically
* setting its location. Most windowing systems cascade windows if their
* locations are not explicitly set. The actual location is determined once the
* window is shown on the screen.
* setVisible
, setLocation
and
* setBounds
after calling setLocationByPlatform
clear
* this property of the Window.
*
* The window will be shown at platform's default location and
*
* setLocationByPlatform(true);
* setVisible(true);
* boolean flag = isLocationByPlatform();
*
flag
will be false
.
*
* The window will be shown at (10, 10) and
* setLocationByPlatform(true);
* setLocation(10, 10);
* boolean flag = isLocationByPlatform();
* setVisible(true);
*
flag
will be
* false
.
*
* @param locationByPlatform true
if this Window should appear
* at the default location, false
if at the current location
* @throws IllegalComponentStateException
if the window
* is showing on screen and locationByPlatform is true
.
* @see #setLocation
* @see #isShowing
* @see #setVisible
* @see #isLocationByPlatform
* @see java.lang.System#getProperty(String)
* @since 1.5
*/
public void setLocationByPlatform(boolean locationByPlatform) {
synchronized (getTreeLock()) {
if (locationByPlatform && isShowing()) {
throw new IllegalComponentStateException("The window is showing on screen.");
}
this.locationByPlatform = locationByPlatform;
}
}
/**
* Returns true
if this Window will appear at the default location
* for the native windowing system the next time this Window is made visible.
* This method always returns false
if the Window is showing on the
* screen.
*
* @return whether this Window will appear at the default location
* @see #setLocationByPlatform
* @see #isShowing
* @since 1.5
*/
public boolean isLocationByPlatform() {
synchronized (getTreeLock()) {
return locationByPlatform;
}
}
/**
* @since 1.5
* @see #setLocationByPlatform
* @see #isLocationByPlatform
*/
public void setBounds(int x, int y, int width, int height) {
synchronized (getTreeLock()) {
if (getBoundsOp() == ComponentPeer.SET_LOCATION ||
getBoundsOp() == ComponentPeer.SET_BOUNDS)
{
locationByPlatform = false;
}
super.setBounds(x, y, width, height);
}
}
} // class Window
/**
* This class is no longer used, but is maintained for Serialization
* backward-compatibility.
*/
class FocusManager implements java.io.Serializable {
Container focusRoot;
Component focusOwner;
/*
* JDK 1.1 serialVersionUID
*/
static final long serialVersionUID = 2491878825643557906L;
}