/*
* Copyright (c) 1995, 2017, Oracle and/or its affiliates. All rights reserved.
* ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*/
package java.awt;
import java.awt.event.*;
import java.awt.geom.
Path2D;
import java.awt.geom.
Point2D;
import java.awt.im.
InputContext;
import java.awt.image.
BufferStrategy;
import java.awt.image.
BufferedImage;
import java.awt.peer.
ComponentPeer;
import java.awt.peer.
WindowPeer;
import java.beans.
PropertyChangeListener;
import java.io.
IOException;
import java.io.
ObjectInputStream;
import java.io.
ObjectOutputStream;
import java.io.
OptionalDataException;
import java.io.
Serializable;
import java.lang.ref.
WeakReference;
import java.lang.reflect.
InvocationTargetException;
import java.security.
AccessController;
import java.util.
ArrayList;
import java.util.
Arrays;
import java.util.
EventListener;
import java.util.
Locale;
import java.util.
ResourceBundle;
import java.util.
Set;
import java.util.
Vector;
import java.util.concurrent.atomic.
AtomicBoolean;
import javax.accessibility.*;
import sun.awt.
AWTAccessor;
import sun.awt.
AppContext;
import sun.awt.
CausedFocusEvent;
import sun.awt.
SunToolkit;
import sun.awt.util.
IdentityArrayList;
import sun.java2d.
Disposer;
import sun.java2d.pipe.
Region;
import sun.security.action.
GetPropertyAction;
import sun.security.util.
SecurityConstants;
import sun.util.logging.
PlatformLogger;
/**
* A {@code Window} object is a top-level window with no borders and no
* menubar.
* The default layout for a window is {@code BorderLayout}.
* <p>
* A window must have either a frame, dialog, or another window defined as its
* owner when it's constructed.
* <p>
* In a multi-screen environment, you can create a {@code Window}
* on a different screen device by constructing the {@code Window}
* with {@link #Window(Window, GraphicsConfiguration)}. The
* {@code GraphicsConfiguration} object is one of the
* {@code GraphicsConfiguration} objects of the target screen device.
* <p>
* 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.
* <p>
* <img src="doc-files/MultiScreen.gif"
* alt="Diagram shows virtual device containing 4 physical screens. Primary physical screen shows coords (0,0), other screen shows (-80,-100)."
* style="float:center; margin: 7px 10px;">
* <p>
* In such an environment, when calling {@code setLocation},
* you must pass a virtual coordinate to this method. Similarly,
* calling {@code getLocationOnScreen} on a {@code Window} returns
* virtual device coordinates. Call the {@code getBounds} method
* of a {@code GraphicsConfiguration} to find its origin in the virtual
* coordinate system.
* <p>
* The following code sets the location of a {@code Window}
* at (10, 10) relative to the origin of the physical screen
* of the corresponding {@code GraphicsConfiguration}. If the
* bounds of the {@code GraphicsConfiguration} is not taken
* into account, the {@code 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 {@code GraphicsConfiguration}.
*
* <pre>
* Window w = new Window(Window owner, GraphicsConfiguration gc);
* Rectangle bounds = gc.getBounds();
* w.setLocation(10 + bounds.x, 10 + bounds.y);
* </pre>
*
* <p>
* Note: the location and size of top-level windows (including
* {@code Window}s, {@code Frame}s, and {@code Dialog}s)
* are under the control of the desktop's window management system.
* Calls to {@code setLocation}, {@code setSize}, and
* {@code 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 {@code Window} in a way
* that more closely matches the desktop settings.
* <p>
* Due to the asynchronous nature of native event handling, the results
* returned by {@code getBounds}, {@code getLocation},
* {@code getLocationOnScreen}, and {@code 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.
* <p>
* An application may set the size and location of an invisible
* {@code Window} arbitrarily, but the window management system may
* subsequently change its size and/or location when the
* {@code Window} is made visible. One or more {@code ComponentEvent}s
* will be generated to indicate the new geometry.
* <p>
* Windows are capable of generating the following WindowEvents:
* WindowOpened, WindowClosed, WindowGainedFocus, WindowLostFocus.
*
* @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 {
/**
* Enumeration of available <i>window types</i>.
*
* A window type defines the generic visual appearance and behavior of a
* top-level window. For example, the type may affect the kind of
* decorations of a decorated {@code Frame} or {@code Dialog} instance.
* <p>
* Some platforms may not fully support a certain window type. Depending on
* the level of support, some properties of the window type may be
* disobeyed.
*
* @see #getType
* @see #setType
* @since 1.7
*/
public static enum
Type {
/**
* Represents a <i>normal</i> window.
*
* This is the default type for objects of the {@code Window} class or
* its descendants. Use this type for regular top-level windows.
*/
NORMAL,
/**
* Represents a <i>utility</i> window.
*
* A utility window is usually a small window such as a toolbar or a
* palette. The native system may render the window with smaller
* title-bar if the window is either a {@code Frame} or a {@code
* Dialog} object, and if it has its decorations enabled.
*/
UTILITY,
/**
* Represents a <i>popup</i> window.
*
* A popup window is a temporary window such as a drop-down menu or a
* tooltip. On some platforms, windows of that type may be forcibly
* made undecorated even if they are instances of the {@code Frame} or
* {@code Dialog} class, and have decorations enabled.
*/
POPUP
}
/**
* This represents the warning message that is
* to be displayed in a non secure window. ie :
* a window that has a security manager installed that denies
* {@code AWTPermission("showWindowWithoutWarningBanner")}.
* This message can be displayed anywhere in the window.
*
* @serial
* @see #getWarningString
*/
String warningString;
/**
* {@code icons} is the graphical way we can
* represent the frames and dialogs.
* {@code Window} can't display icon but it's
* being inherited by owned {@code Dialog}s.
*
* @serial
* @see #getIconImages
* @see #setIconImages
*/
transient java.util.
List<
Image>
icons;
/**
* 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;
private transient boolean
disposing = false;
transient
WindowDisposerRecord disposerRecord = null;
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;
/**
* Contains all the windows that have a peer object associated,
* i. e. between addNotify() and removeNotify() calls. The list
* of all Window instances can be obtained from AppContext object.
*
* @since 1.6
*/
private static final
IdentityArrayList<
Window>
allWindows = new
IdentityArrayList<
Window>();
/**
* A vector containing all the windows this
* window currently owns.
* @since 1.2
* @see #getOwnedWindows
*/
transient
Vector<
WeakReference<
Window>>
ownedWindowList =
new
Vector<
WeakReference<
Window>>();
/*
* We insert a weak reference into the Vector of all Windows in AppContext
* instead of 'this' so that garbage collection can still take place
* correctly.
*/
private transient
WeakReference<
Window>
weakThis;
transient boolean
showWithParent;
/**
* Contains the modal dialog that blocks this window, or null
* if the window is unblocked.
*
* @since 1.6
*/
transient
Dialog modalBlocker;
/**
* @serial
*
* @see java.awt.Dialog.ModalExclusionType
* @see #getModalExclusionType
* @see #setModalExclusionType
*
* @since 1.6
*/
Dialog.
ModalExclusionType modalExclusionType;
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;
/**
* Indicates whether this window should receive focus on
* subsequently being shown (with a call to {@code setVisible(true)}), or
* being moved to the front (with a call to {@code toFront()}).
*
* @serial
* @see #setAutoRequestFocus
* @see #isAutoRequestFocus
* @since 1.7
*/
private volatile boolean
autoRequestFocus = true;
/*
* Indicates that this window is being shown. This flag is set to true at
* the beginning of show() and to false at the end of show().
*
* @see #show()
* @see Dialog#shouldBlock
*/
transient boolean
isInShow = false;
/**
* The opacity level of the window
*
* @serial
* @see #setOpacity(float)
* @see #getOpacity()
* @since 1.7
*/
private volatile float
opacity = 1.0f;
/**
* The shape assigned to this window. This field is set to {@code null} if
* no shape is set (rectangular window).
*
* @serial
* @see #getShape()
* @see #setShape(Shape)
* @since 1.7
*/
private
Shape shape = null;
private static final
String base = "win";
private static int
nameCounter = 0;
/*
* JDK 1.1 serialVersionUID
*/
private static final long
serialVersionUID = 4497834738069338734L;
private static final
PlatformLogger log =
PlatformLogger.
getLogger("java.awt.Window");
private static final boolean
locationByPlatformProp;
transient boolean
isTrayIconWindow = false;
/**
* These fields are initialized in the native peer code
* or via AWTAccessor's WindowAccessor.
*/
private transient volatile int
securityWarningWidth = 0;
private transient volatile int
securityWarningHeight = 0;
/**
* These fields represent the desired location for the security
* warning if this window is untrusted.
* See com.sun.awt.SecurityWarning for more details.
*/
private transient double
securityWarningPointX = 2.0;
private transient double
securityWarningPointY = 0.0;
private transient float
securityWarningAlignmentX =
RIGHT_ALIGNMENT;
private transient float
securityWarningAlignmentY =
TOP_ALIGNMENT;
static {
/* ensure that the necessary native libraries are loaded */
Toolkit.
loadLibraries();
if (!
GraphicsEnvironment.
isHeadless()) {
initIDs();
}
String s = java.security.
AccessController.
doPrivileged(
new
GetPropertyAction("java.awt.syncLWRequests"));
systemSyncLWRequests = (
s != null &&
s.
equals("true"));
s = 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, initially invisible window in default size with the
* specified {@code GraphicsConfiguration}.
* <p>
* If there is a security manager, then it is invoked to check
* {@code AWTPermission("showWindowWithoutWarningBanner")}
* to determine whether or not the window must be displayed with
* a warning banner.
*
* @param gc the {@code GraphicsConfiguration} of the target screen
* device. If {@code gc} is {@code null}, the system default
* {@code GraphicsConfiguration} is assumed
* @exception IllegalArgumentException if {@code gc}
* is not from a screen device
* @exception HeadlessException when
* {@code GraphicsEnvironment.isHeadless()} returns {@code true}
*
* @see java.awt.GraphicsEnvironment#isHeadless
*/
Window(
GraphicsConfiguration gc) {
init(
gc);
}
transient
Object anchor = new
Object();
static class
WindowDisposerRecord implements sun.java2d.
DisposerRecord {
WeakReference<
Window>
owner;
final
WeakReference<
Window>
weakThis;
final
WeakReference<
AppContext>
context;
WindowDisposerRecord(
AppContext context,
Window victim) {
weakThis =
victim.
weakThis;
this.
context = new
WeakReference<
AppContext>(
context);
}
public void
updateOwner() {
Window victim =
weakThis.
get();
owner = (
victim == null)
? null
: new
WeakReference<
Window>(
victim.
getOwner());
}
public void
dispose() {
if (
owner != null) {
Window parent =
owner.
get();
if (
parent != null) {
parent.
removeOwnedWindow(
weakThis);
}
}
AppContext ac =
context.
get();
if (null !=
ac) {
Window.
removeFromWindowList(
ac,
weakThis);
}
}
}
private
GraphicsConfiguration initGC(
GraphicsConfiguration gc) {
GraphicsEnvironment.
checkHeadless();
if (
gc == null) {
gc =
GraphicsEnvironment.
getLocalGraphicsEnvironment().
getDefaultScreenDevice().
getDefaultConfiguration();
}
setGraphicsConfiguration(
gc);
return
gc;
}
private void
init(
GraphicsConfiguration gc) {
GraphicsEnvironment.
checkHeadless();
syncLWRequests =
systemSyncLWRequests;
weakThis = new
WeakReference<
Window>(this);
addToWindowList();
setWarningString();
this.
cursor =
Cursor.
getPredefinedCursor(
Cursor.
DEFAULT_CURSOR);
this.
visible = false;
gc =
initGC(
gc);
if (
gc.
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 =
gc.
getBounds();
Insets screenInsets =
getToolkit().
getScreenInsets(
gc);
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);
}
modalExclusionType =
Dialog.
ModalExclusionType.
NO_EXCLUDE;
disposerRecord = new
WindowDisposerRecord(
appContext, this);
sun.java2d.
Disposer.
addRecord(
anchor,
disposerRecord);
SunToolkit.
checkAndSetPolicy(this);
}
/**
* Constructs a new, initially invisible window in the default size.
* <p>
* If there is a security manager set, it is invoked to check
* {@code AWTPermission("showWindowWithoutWarningBanner")}.
* If that check fails with a {@code SecurityException} then a warning
* banner is created.
*
* @exception HeadlessException when
* {@code GraphicsEnvironment.isHeadless()} returns {@code true}
*
* @see java.awt.GraphicsEnvironment#isHeadless
*/
Window() throws
HeadlessException {
GraphicsEnvironment.
checkHeadless();
init((
GraphicsConfiguration)null);
}
/**
* Constructs a new, initially invisible window with the specified
* {@code Frame} as its owner. The window will not be focusable
* unless its owner is showing on the screen.
* <p>
* If there is a security manager set, it is invoked to check
* {@code AWTPermission("showWindowWithoutWarningBanner")}.
* If that check fails with a {@code SecurityException} then a warning
* banner is created.
*
* @param owner the {@code Frame} to act as owner or {@code null}
* if this window has no owner
* @exception IllegalArgumentException if the {@code owner}'s
* {@code GraphicsConfiguration} is not from a screen device
* @exception HeadlessException when
* {@code GraphicsEnvironment.isHeadless} returns {@code true}
*
* @see java.awt.GraphicsEnvironment#isHeadless
* @see #isShowing
*/
public
Window(
Frame owner) {
this(
owner == null ? (
GraphicsConfiguration)null :
owner.
getGraphicsConfiguration());
ownedInit(
owner);
}
/**
* Constructs a new, initially invisible window with the specified
* {@code Window} as its owner. This window will not be focusable
* unless its nearest owning {@code Frame} or {@code Dialog}
* is showing on the screen.
* <p>
* If there is a security manager set, it is invoked to check
* {@code AWTPermission("showWindowWithoutWarningBanner")}.
* If that check fails with a {@code SecurityException} then a
* warning banner is created.
*
* @param owner the {@code Window} to act as owner or
* {@code null} if this window has no owner
* @exception IllegalArgumentException if the {@code owner}'s
* {@code GraphicsConfiguration} is not from a screen device
* @exception HeadlessException when
* {@code GraphicsEnvironment.isHeadless()} returns
* {@code true}
*
* @see java.awt.GraphicsEnvironment#isHeadless
* @see #isShowing
*
* @since 1.2
*/
public
Window(
Window owner) {
this(
owner == null ? (
GraphicsConfiguration)null :
owner.
getGraphicsConfiguration());
ownedInit(
owner);
}
/**
* Constructs a new, initially invisible window with the specified owner
* {@code Window} and a {@code GraphicsConfiguration}
* of a screen device. The Window will not be focusable unless
* its nearest owning {@code Frame} or {@code Dialog}
* is showing on the screen.
* <p>
* If there is a security manager set, it is invoked to check
* {@code AWTPermission("showWindowWithoutWarningBanner")}. If that
* check fails with a {@code SecurityException} then a warning banner
* is created.
*
* @param owner the window to act as owner or {@code null}
* if this window has no owner
* @param gc the {@code GraphicsConfiguration} of the target
* screen device; if {@code gc} is {@code null},
* the system default {@code GraphicsConfiguration} is assumed
* @exception IllegalArgumentException if {@code gc}
* is not from a screen device
* @exception HeadlessException when
* {@code GraphicsEnvironment.isHeadless()} returns
* {@code true}
*
* @see java.awt.GraphicsEnvironment#isHeadless
* @see GraphicsConfiguration#getBounds
* @see #isShowing
* @since 1.3
*/
public
Window(
Window owner,
GraphicsConfiguration gc) {
this(
gc);
ownedInit(
owner);
}
private void
ownedInit(
Window owner) {
this.
parent =
owner;
if (
owner != null) {
owner.
addOwnedWindow(
weakThis);
if (
owner.
isAlwaysOnTop()) {
try {
setAlwaysOnTop(true);
} catch (
SecurityException ignore) {
}
}
}
// WindowDisposerRecord requires a proper value of parent field.
disposerRecord.
updateOwner();
}
/**
* Construct a name for this component. Called by getName() when the
* name is null.
*/
String constructComponentName() {
synchronized (
Window.class) {
return
base +
nameCounter++;
}
}
/**
* Returns the sequence of images to be displayed as the icon for this window.
* <p>
* This method returns a copy of the internally stored list, so all operations
* on the returned object will not affect the window's behavior.
*
* @return the copy of icon images' list for this window, or
* empty list if this window doesn't have icon images.
* @see #setIconImages
* @see #setIconImage(Image)
* @since 1.6
*/
public java.util.
List<
Image>
getIconImages() {
java.util.
List<
Image>
icons = this.
icons;
if (
icons == null ||
icons.
size() == 0) {
return new
ArrayList<
Image>();
}
return new
ArrayList<
Image>(
icons);
}
/**
* Sets the sequence of images to be displayed as the icon
* for this window. Subsequent calls to {@code getIconImages} will
* always return a copy of the {@code icons} list.
* <p>
* Depending on the platform capabilities one or several images
* of different dimensions will be used as the window's icon.
* <p>
* The {@code icons} list is scanned for the images of most
* appropriate dimensions from the beginning. If the list contains
* several images of the same size, the first will be used.
* <p>
* Ownerless windows with no icon specified use platfrom-default icon.
* The icon of an owned window may be inherited from the owner
* unless explicitly overridden.
* Setting the icon to {@code null} or empty list restores
* the default behavior.
* <p>
* Note : Native windowing systems may use different images of differing
* dimensions to represent a window, depending on the context (e.g.
* window decoration, window list, taskbar, etc.). They could also use
* just a single image for all contexts or no image at all.
*
* @param icons the list of icon images to be displayed.
* @see #getIconImages()
* @see #setIconImage(Image)
* @since 1.6
*/
public synchronized void
setIconImages(java.util.
List<? extends
Image>
icons) {
this.
icons = (
icons == null) ? new
ArrayList<
Image>() :
new
ArrayList<
Image>(
icons);
WindowPeer peer = (
WindowPeer)this.
peer;
if (
peer != null) {
peer.
updateIconImages();
}
// Always send a property change event
firePropertyChange("iconImage", null, null);
}
/**
* Sets the image to be displayed as the icon for this window.
* <p>
* This method can be used instead of {@link #setIconImages setIconImages()}
* to specify a single image as a window's icon.
* <p>
* The following statement:
* <pre>
* setIconImage(image);
* </pre>
* is equivalent to:
* <pre>
* ArrayList<Image> imageList = new ArrayList<Image>();
* imageList.add(image);
* setIconImages(imageList);
* </pre>
* <p>
* Note : Native windowing systems may use different images of differing
* dimensions to represent a window, depending on the context (e.g.
* window decoration, window list, taskbar, etc.). They could also use
* just a single image for all contexts or no image at all.
*
* @param image the icon image to be displayed.
* @see #setIconImages
* @see #getIconImages()
* @since 1.6
*/
public void
setIconImage(
Image image) {
ArrayList<
Image>
imageList = new
ArrayList<
Image>();
if (
image != null) {
imageList.
add(
image);
}
setIconImages(
imageList);
}
/**
* 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);
}
synchronized (
allWindows) {
allWindows.
add(this);
}
super.addNotify();
}
}
/**
* {@inheritDoc}
*/
public void
removeNotify() {
synchronized (
getTreeLock()) {
synchronized (
allWindows) {
allWindows.
remove(this);
}
super.removeNotify();
}
}
/**
* Causes this Window to be sized to fit the preferred size
* and layouts of its subcomponents. The resulting width and
* height of the window are automatically enlarged if either
* of dimensions is less than the minimum size as specified
* by the previous call to the {@code setMinimumSize} method.
* <p>
* If the window and/or its owner are not displayable yet,
* both of them are made displayable before calculating
* the preferred size. The Window is validated after its
* size is being calculated.
*
* @see Component#isDisplayable
* @see #setMinimumSize
*/
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;
}
validateUnconditionally();
}
/**
* Sets the minimum size of this window to a constant
* value. Subsequent calls to {@code getMinimumSize}
* will always return this value. If current window's
* size is less than {@code minimumSize} the size of the
* window is automatically enlarged to honor the minimum size.
* <p>
* If the {@code setSize} or {@code setBounds} methods
* are called afterwards with a width or height less than
* that was specified by the {@code setMinimumSize} method
* the window is automatically enlarged to meet
* the {@code minimumSize} value. The {@code minimumSize}
* value also affects the behaviour of the {@code pack} method.
* <p>
* The default behavior is restored by setting the minimum size
* parameter to the {@code null} value.
* <p>
* Resizing operation may be restricted if the user tries
* to resize window below the {@code minimumSize} value.
* This behaviour is platform-dependent.
*
* @param minimumSize the new minimum size of this window
* @see Component#setMinimumSize
* @see #getMinimumSize
* @see #isMinimumSizeSet
* @see #setSize(Dimension)
* @see #pack
* @since 1.6
*/
public void
setMinimumSize(
Dimension minimumSize) {
synchronized (
getTreeLock()) {
super.setMinimumSize(
minimumSize);
Dimension size =
getSize();
if (
isMinimumSizeSet()) {
if (
size.
width <
minimumSize.
width ||
size.
height <
minimumSize.
height) {
int
nw =
Math.
max(
width,
minimumSize.
width);
int
nh =
Math.
max(
height,
minimumSize.
height);
setSize(
nw,
nh);
}
}
if (
peer != null) {
((
WindowPeer)
peer).
updateMinimumSize();
}
}
}
/**
* {@inheritDoc}
* <p>
* The {@code d.width} and {@code d.height} values
* are automatically enlarged if either is less than
* the minimum size as specified by previous call to
* {@code setMinimumSize}.
* <p>
* The method changes the geometry-related data. Therefore,
* the native windowing system may ignore such requests, or it may modify
* the requested data, so that the {@code Window} object is placed and sized
* in a way that corresponds closely to the desktop settings.
*
* @see #getSize
* @see #setBounds
* @see #setMinimumSize
* @since 1.6
*/
public void
setSize(
Dimension d) {
super.setSize(
d);
}
/**
* {@inheritDoc}
* <p>
* The {@code width} and {@code height} values
* are automatically enlarged if either is less than
* the minimum size as specified by previous call to
* {@code setMinimumSize}.
* <p>
* The method changes the geometry-related data. Therefore,
* the native windowing system may ignore such requests, or it may modify
* the requested data, so that the {@code Window} object is placed and sized
* in a way that corresponds closely to the desktop settings.
*
* @see #getSize
* @see #setBounds
* @see #setMinimumSize
* @since 1.6
*/
public void
setSize(int
width, int
height) {
super.setSize(
width,
height);
}
/**
* {@inheritDoc}
* <p>
* The method changes the geometry-related data. Therefore,
* the native windowing system may ignore such requests, or it may modify
* the requested data, so that the {@code Window} object is placed and sized
* in a way that corresponds closely to the desktop settings.
*/
@
Override
public void
setLocation(int
x, int
y) {
super.setLocation(
x,
y);
}
/**
* {@inheritDoc}
* <p>
* The method changes the geometry-related data. Therefore,
* the native windowing system may ignore such requests, or it may modify
* the requested data, so that the {@code Window} object is placed and sized
* in a way that corresponds closely to the desktop settings.
*/
@
Override
public void
setLocation(
Point p) {
super.setLocation(
p);
}
/**
* @deprecated As of JDK version 1.1,
* replaced by {@code setBounds(int, int, int, int)}.
*/
@
Deprecated
public void
reshape(int
x, int
y, int
width, int
height) {
if (
isMinimumSizeSet()) {
Dimension minSize =
getMinimumSize();
if (
width <
minSize.
width) {
width =
minSize.
width;
}
if (
height <
minSize.
height) {
height =
minSize.
height;
}
}
super.reshape(
x,
y,
width,
height);
}
void
setClientSize(int
w, int
h) {
synchronized (
getTreeLock()) {
setBoundsOp(
ComponentPeer.
SET_CLIENT_SIZE);
setBounds(
x,
y,
w,
h);
}
}
static private final
AtomicBoolean
beforeFirstWindowShown = new
AtomicBoolean(true);
final void
closeSplashScreen() {
if (
isTrayIconWindow) {
return;
}
if (
beforeFirstWindowShown.
getAndSet(false)) {
// We don't use SplashScreen.getSplashScreen() to avoid instantiating
// the object if it hasn't been requested by user code explicitly
SunToolkit.
closeSplashScreen();
SplashScreen.
markClosed();
}
}
/**
* Shows or hides this {@code Window} depending on the value of parameter
* {@code b}.
* <p>
* If the method shows the window then the window is also made
* focused under the following conditions:
* <ul>
* <li> The {@code Window} meets the requirements outlined in the
* {@link #isFocusableWindow} method.
* <li> The {@code Window}'s {@code autoRequestFocus} property is of the {@code true} value.
* <li> Native windowing system allows the {@code Window} to get focused.
* </ul>
* There is an exception for the second condition (the value of the
* {@code autoRequestFocus} property). The property is not taken into account if the
* window is a modal dialog, which blocks the currently focused window.
* <p>
* Developers must never assume that the window is the focused or active window
* until it receives a WINDOW_GAINED_FOCUS or WINDOW_ACTIVATED event.
* @param b if {@code true}, makes the {@code Window} visible,
* otherwise hides the {@code Window}.
* If the {@code Window} and/or its owner
* are not yet displayable, both are made displayable. The
* {@code Window} will be validated prior to being made visible.
* If the {@code Window} is already visible, this will bring the
* {@code Window} to the front.<p>
* If {@code false}, hides this {@code Window}, its subcomponents, and all
* of its owned children.
* The {@code Window} and its subcomponents can be made visible again
* with a call to {@code #setVisible(true)}.
* @see java.awt.Component#isDisplayable
* @see java.awt.Component#setVisible
* @see java.awt.Window#toFront
* @see java.awt.Window#dispose
* @see java.awt.Window#setAutoRequestFocus
* @see java.awt.Window#isFocusableWindow
*/
public void
setVisible(boolean
b) {
super.setVisible(
b);
}
/**
* Makes the Window visible. If the Window and/or its owner
* are not yet displayable, both are made displayable. The
* Window will be validated prior to being made visible.
* If the Window is already visible, this will bring the Window
* to the front.
* @see Component#isDisplayable
* @see #toFront
* @deprecated As of JDK version 1.5, replaced by
* {@link #setVisible(boolean)}.
*/
@
Deprecated
public void
show() {
if (
peer == null) {
addNotify();
}
validateUnconditionally();
isInShow = true;
if (
visible) {
toFront();
} else {
beforeFirstShow = false;
closeSplashScreen();
Dialog.
checkShouldBeBlocked(this);
super.show();
locationByPlatform = false;
for (int
i = 0;
i <
ownedWindowList.
size();
i++) {
Window child =
ownedWindowList.
elementAt(
i).
get();
if ((
child != null) &&
child.
showWithParent) {
child.
show();
child.
showWithParent = false;
} // endif
} // endfor
if (!
isModalBlocked()) {
updateChildrenBlocking();
} else {
// fix for 6532736: after this window is shown, its blocker
// should be raised to front
modalBlocker.
toFront_NoClientCode();
}
if (this instanceof
Frame || this instanceof
Dialog) {
updateChildFocusableWindowState(this);
}
}
isInShow = false;
// If first time shown, generate WindowOpened event
if ((
state &
OPENED) == 0) {
postWindowEvent(
WindowEvent.
WINDOW_OPENED);
state |=
OPENED;
}
}
static void
updateChildFocusableWindowState(
Window w) {
if (
w.
getPeer() != null &&
w.
isShowing()) {
((
WindowPeer)
w.
getPeer()).
updateFocusableWindowState();
}
for (int
i = 0;
i <
w.
ownedWindowList.
size();
i++) {
Window child =
w.
ownedWindowList.
elementAt(
i).
get();
if (
child != null) {
updateChildFocusableWindowState(
child);
}
}
}
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);
}
}
/**
* Hide this Window, its subcomponents, and all of its owned children.
* The Window and its subcomponents can be made visible again
* with a call to {@code show}.
* @see #show
* @see #dispose
* @deprecated As of JDK version 1.5, replaced by
* {@link #setVisible(boolean)}.
*/
@
Deprecated
public void
hide() {
synchronized(
ownedWindowList) {
for (int
i = 0;
i <
ownedWindowList.
size();
i++) {
Window child =
ownedWindowList.
elementAt(
i).
get();
if ((
child != null) &&
child.
visible) {
child.
hide();
child.
showWithParent = true;
}
}
}
if (
isModalBlocked()) {
modalBlocker.
unblockWindow(this);
}
super.hide();
locationByPlatform = false;
}
final void
clearMostRecentFocusOwnerOnHide() {
/* do nothing */
}
/**
* Releases all of the native screen resources used by this
* {@code Window}, its subcomponents, and all of its owned
* children. That is, the resources for these {@code Component}s
* will be destroyed, any memory they consume will be returned to the
* OS, and they will be marked as undisplayable.
* <p>
* The {@code Window} and its subcomponents can be made displayable
* again by rebuilding the native resources with a subsequent call to
* {@code pack} or {@code show}. The states of the recreated
* {@code Window} and its subcomponents will be identical to the
* states of these objects at the point where the {@code Window}
* was disposed (not accounting for additional modifications between
* those actions).
* <p>
* <b>Note</b>: When the last displayable window
* within the Java virtual machine (VM) is disposed of, the VM may
* terminate. See <a href="doc-files/AWTThreadIssues.html#Autoshutdown">
* AWT Threading Issues</a> 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() {
disposing = true;
try {
// Check if this window is the fullscreen window for the
// device. Exit the fullscreen mode prior to disposing
// of the window if that's the case.
GraphicsDevice gd =
getGraphicsConfiguration().
getDevice();
if (
gd.
getFullScreenWindow() ==
Window.this) {
gd.
setFullScreenWindow(null);
}
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();
} finally {
disposing = false;
}
}
}
boolean
fireWindowClosedEvent =
isDisplayable();
DisposeAction action = new
DisposeAction();
if (
EventQueue.
isDispatchThread()) {
action.
run();
}
else {
try {
EventQueue.
invokeAndWait(this,
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.
if (
fireWindowClosedEvent) {
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.
* <p>
* 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.
* <p>
* 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 <b>probably</b> focus this Window (if it is not already focused)
* under the following conditions:
* <ul>
* <li> The window meets the requirements outlined in the
* {@link #isFocusableWindow} method.
* <li> The window's property {@code autoRequestFocus} is of the
* {@code true} value.
* <li> Native windowing system allows the window to get focused.
* </ul>
* On platforms where the stacking order does not typically affect the focused
* window, this method will <b>probably</b> leave the focused and active
* Windows unchanged.
* <p>
* 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.
* <p>
* If this window is blocked by modal dialog, then the blocking dialog
* is brought to the front and remains above the blocked window.
*
* @see #toBack
* @see #setAutoRequestFocus
* @see #isFocusableWindow
*/
public void
toFront() {
toFront_NoClientCode();
}
// This functionality is implemented in a final package-private method
// to insure that it cannot be overridden by client subclasses.
final void
toFront_NoClientCode() {
if (
visible) {
WindowPeer peer = (
WindowPeer)this.
peer;
if (
peer != null) {
peer.
toFront();
}
if (
isModalBlocked()) {
modalBlocker.
toFront_NoClientCode();
}
}
}
/**
* 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.
* <p>
* 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.
* <p>
* 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 <b>probably</b> 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 <b>probably</b> leave the focused
* and active Windows unchanged.
*
* @see #toFront
*/
public void
toBack() {
toBack_NoClientCode();
}
// This functionality is implemented in a final package-private method
// to insure that it cannot be overridden by client subclasses.
final void
toBack_NoClientCode() {
if(
isAlwaysOnTop()) {
try {
setAlwaysOnTop(false);
}catch(
SecurityException e) {
}
}
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 denies
* {@code AWTPermission("showWindowWithoutWarningBanner")}.
* <p>
* If the window is secure, then {@code getWarningString}
* returns {@code null}. If the window is insecure, this
* method checks for the system property
* {@code awt.appletWarning}
* and returns the string value of that property.
* @return the warning string for this window.
*/
public final
String getWarningString() {
return
warningString;
}
private void
setWarningString() {
warningString = null;
SecurityManager sm =
System.
getSecurityManager();
if (
sm != null) {
try {
sm.
checkPermission(
SecurityConstants.
AWT.
TOPLEVEL_WINDOW_PERMISSION);
} catch (
SecurityException se) {
// make sure the privileged action is only
// for getting the property! We don't want the
// above checkPermission call to always succeed!
warningString =
AccessController.
doPrivileged(
new
GetPropertyAction("awt.appletWarning",
"Java Applet Window"));
}
}
}
/**
* Gets the {@code 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() {
synchronized (
inputContextLock) {
if (
inputContext == null) {
inputContext =
InputContext.
getInstance();
}
}
return
inputContext;
}
/**
* Set the cursor image to a specified cursor.
* <p>
* The method may have no visual effect if the Java platform
* implementation and/or the native system do not support
* changing the mouse cursor shape.
* @param cursor One of the constants defined
* by the {@code 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
getOwner_NoClientCode();
}
final
Window getOwner_NoClientCode() {
return (
Window)
parent;
}
/**
* Return an array containing all the windows this
* window currently owns.
* @since 1.2
*/
public
Window[]
getOwnedWindows() {
return
getOwnedWindows_NoClientCode();
}
final
Window[]
getOwnedWindows_NoClientCode() {
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] =
ownedWindowList.
elementAt(
i).
get();
if (
fullCopy[
realSize] != null) {
realSize++;
}
}
if (
fullSize !=
realSize) {
realCopy =
Arrays.
copyOf(
fullCopy,
realSize);
} else {
realCopy =
fullCopy;
}
}
return
realCopy;
}
boolean
isModalBlocked() {
return
modalBlocker != null;
}
void
setModalBlocked(
Dialog blocker, boolean
blocked, boolean
peerCall) {
this.
modalBlocker =
blocked ?
blocker : null;
if (
peerCall) {
WindowPeer peer = (
WindowPeer)this.
peer;
if (
peer != null) {
peer.
setModalBlocked(
blocker,
blocked);
}
}
}
Dialog getModalBlocker() {
return
modalBlocker;
}
/*
* Returns a list of all displayable Windows, i. e. all the
* Windows which peer is not null.
*
* @see #addNotify
* @see #removeNotify
*/
static
IdentityArrayList<
Window>
getAllWindows() {
synchronized (
allWindows) {
IdentityArrayList<
Window>
v = new
IdentityArrayList<
Window>();
v.
addAll(
allWindows);
return
v;
}
}
static
IdentityArrayList<
Window>
getAllUnblockedWindows() {
synchronized (
allWindows) {
IdentityArrayList<
Window>
unblocked = new
IdentityArrayList<
Window>();
for (int
i = 0;
i <
allWindows.
size();
i++) {
Window w =
allWindows.
get(
i);
if (!
w.
isModalBlocked()) {
unblocked.
add(
w);
}
}
return
unblocked;
}
}
private static
Window[]
getWindows(
AppContext appContext) {
synchronized (
Window.class) {
Window realCopy[];
@
SuppressWarnings("unchecked")
Vector<
WeakReference<
Window>>
windowList =
(
Vector<
WeakReference<
Window>>)
appContext.
get(
Window.class);
if (
windowList != null) {
int
fullSize =
windowList.
size();
int
realSize = 0;
Window fullCopy[] = new
Window[
fullSize];
for (int
i = 0;
i <
fullSize;
i++) {
Window w =
windowList.
get(
i).
get();
if (
w != null) {
fullCopy[
realSize++] =
w;
}
}
if (
fullSize !=
realSize) {
realCopy =
Arrays.
copyOf(
fullCopy,
realSize);
} else {
realCopy =
fullCopy;
}
} else {
realCopy = new
Window[0];
}
return
realCopy;
}
}
/**
* Returns an array of all {@code Window}s, both owned and ownerless,
* created by this application.
* If called from an applet, the array includes only the {@code Window}s
* accessible by that applet.
* <p>
* <b>Warning:</b> this method may return system created windows, such
* as a print dialog. Applications should not assume the existence of
* these dialogs, nor should an application assume anything about these
* dialogs such as component positions, {@code LayoutManager}s
* or serialization.
*
* @see Frame#getFrames
* @see Window#getOwnerlessWindows
*
* @since 1.6
*/
public static
Window[]
getWindows() {
return
getWindows(
AppContext.
getAppContext());
}
/**
* Returns an array of all {@code Window}s created by this application
* that have no owner. They include {@code Frame}s and ownerless
* {@code Dialog}s and {@code Window}s.
* If called from an applet, the array includes only the {@code Window}s
* accessible by that applet.
* <p>
* <b>Warning:</b> this method may return system created windows, such
* as a print dialog. Applications should not assume the existence of
* these dialogs, nor should an application assume anything about these
* dialogs such as component positions, {@code LayoutManager}s
* or serialization.
*
* @see Frame#getFrames
* @see Window#getWindows()
*
* @since 1.6
*/
public static
Window[]
getOwnerlessWindows() {
Window[]
allWindows =
Window.
getWindows();
int
ownerlessCount = 0;
for (
Window w :
allWindows) {
if (
w.
getOwner() == null) {
ownerlessCount++;
}
}
Window[]
ownerless = new
Window[
ownerlessCount];
int
c = 0;
for (
Window w :
allWindows) {
if (
w.
getOwner() == null) {
ownerless[
c++] =
w;
}
}
return
ownerless;
}
Window getDocumentRoot() {
synchronized (
getTreeLock()) {
Window w = this;
while (
w.
getOwner() != null) {
w =
w.
getOwner();
}
return
w;
}
}
/**
* Specifies the modal exclusion type for this window. If a window is modal
* excluded, it is not blocked by some modal dialogs. See {@link
* java.awt.Dialog.ModalExclusionType Dialog.ModalExclusionType} for
* possible modal exclusion types.
* <p>
* If the given type is not supported, {@code NO_EXCLUDE} is used.
* <p>
* Note: changing the modal exclusion type for a visible window may have no
* effect until it is hidden and then shown again.
*
* @param exclusionType the modal exclusion type for this window; a {@code null}
* value is equivalent to {@link Dialog.ModalExclusionType#NO_EXCLUDE
* NO_EXCLUDE}
* @throws SecurityException if the calling thread does not have permission
* to set the modal exclusion property to the window with the given
* {@code exclusionType}
* @see java.awt.Dialog.ModalExclusionType
* @see java.awt.Window#getModalExclusionType
* @see java.awt.Toolkit#isModalExclusionTypeSupported
*
* @since 1.6
*/
public void
setModalExclusionType(
Dialog.
ModalExclusionType exclusionType) {
if (
exclusionType == null) {
exclusionType =
Dialog.
ModalExclusionType.
NO_EXCLUDE;
}
if (!
Toolkit.
getDefaultToolkit().
isModalExclusionTypeSupported(
exclusionType)) {
exclusionType =
Dialog.
ModalExclusionType.
NO_EXCLUDE;
}
if (
modalExclusionType ==
exclusionType) {
return;
}
if (
exclusionType ==
Dialog.
ModalExclusionType.
TOOLKIT_EXCLUDE) {
SecurityManager sm =
System.
getSecurityManager();
if (
sm != null) {
sm.
checkPermission(
SecurityConstants.
AWT.
TOOLKIT_MODALITY_PERMISSION);
}
}
modalExclusionType =
exclusionType;
// if we want on-fly changes, we need to uncomment the lines below
// and override the method in Dialog to use modalShow() instead
// of updateChildrenBlocking()
/*
if (isModalBlocked()) {
modalBlocker.unblockWindow(this);
}
Dialog.checkShouldBeBlocked(this);
updateChildrenBlocking();
*/
}
/**
* Returns the modal exclusion type of this window.
*
* @return the modal exclusion type of this window
*
* @see java.awt.Dialog.ModalExclusionType
* @see java.awt.Window#setModalExclusionType
*
* @since 1.6
*/
public
Dialog.
ModalExclusionType getModalExclusionType() {
return
modalExclusionType;
}
boolean
isModalExcluded(
Dialog.
ModalExclusionType exclusionType) {
if ((
modalExclusionType != null) &&
modalExclusionType.
compareTo(
exclusionType) >= 0)
{
return true;
}
Window owner =
getOwner_NoClientCode();
return (
owner != null) &&
owner.
isModalExcluded(
exclusionType);
}
void
updateChildrenBlocking() {
Vector<
Window>
childHierarchy = new
Vector<
Window>();
Window[]
ownedWindows =
getOwnedWindows();
for (int
i = 0;
i <
ownedWindows.length;
i++) {
childHierarchy.
add(
ownedWindows[
i]);
}
int
k = 0;
while (
k <
childHierarchy.
size()) {
Window w =
childHierarchy.
get(
k);
if (
w.
isVisible()) {
if (
w.
isModalBlocked()) {
Dialog blocker =
w.
getModalBlocker();
blocker.
unblockWindow(
w);
}
Dialog.
checkShouldBeBlocked(
w);
Window[]
wOwned =
w.
getOwnedWindows();
for (int
j = 0;
j <
wOwned.length;
j++) {
childHierarchy.
add(
wOwned[
j]);
}
}
k++;
}
}
/**
* 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.
* <p>Refer to <a href="doc-files/AWTThreadIssues.html#ListenersThreads"
* >AWT Threading Issues</a> for details on AWT's threading model.
*
* @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 {@code l} is {@code null},
* no exception is thrown and no action is performed.
* <p>Refer to <a href="doc-files/AWTThreadIssues.html#ListenersThreads"
* >AWT Threading Issues</a> for details on AWT's threading model.
*
* @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.
* <p>Refer to <a href="doc-files/AWTThreadIssues.html#ListenersThreads"
* >AWT Threading Issues</a> for details on AWT's threading model.
*
* @param l the window focus listener
* @see #removeWindowFocusListener
* @see #getWindowFocusListeners
* @since 1.4
*/
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.
* <p>Refer to <a href="doc-files/AWTThreadIssues.html#ListenersThreads"
* >AWT Threading Issues</a> for details on AWT's threading model.
*
* @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
* {@code l} is {@code null}, no exception is thrown and
* no action is performed.
* <p>Refer to <a href="doc-files/AWTThreadIssues.html#ListenersThreads"
* >AWT Threading Issues</a> for details on AWT's threading model.
*
* @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.
* <p>Refer to <a href="doc-files/AWTThreadIssues.html#ListenersThreads"
* >AWT Threading Issues</a> for details on AWT's threading model.
*
* @param l the window focus listener
* @see #addWindowFocusListener
* @see #getWindowFocusListeners
* @since 1.4
*/
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 {@code 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
getListeners(
WindowListener.class);
}
/**
* Returns an array of all the window focus listeners
* registered on this window.
*
* @return all of this window's {@code 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
getListeners(
WindowFocusListener.class);
}
/**
* Returns an array of all the window state listeners
* registered on this window.
*
* @return all of this window's {@code 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
getListeners(
WindowStateListener.class);
}
/**
* Returns an array of all the objects currently registered
* as <code><em>Foo</em>Listener</code>s
* upon this {@code Window}.
* <code><em>Foo</em>Listener</code>s are registered using the
* <code>add<em>Foo</em>Listener</code> method.
*
* <p>
*
* You can specify the {@code listenerType} argument
* with a class literal, such as
* <code><em>Foo</em>Listener.class</code>.
* For example, you can query a
* {@code Window} {@code w}
* for its window listeners with the following code:
*
* <pre>WindowListener[] wls = (WindowListener[])(w.getListeners(WindowListener.class));</pre>
*
* 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
* {@code java.util.EventListener}
* @return an array of all objects registered as
* <code><em>Foo</em>Listener</code>s on this window,
* or an empty array if no such
* listeners have been added
* @exception ClassCastException if {@code listenerType}
* doesn't specify a class or interface that implements
* {@code java.util.EventListener}
* @exception NullPointerException if {@code listenerType} is {@code null}
*
* @see #getWindowListeners
* @since 1.3
*/
public <T extends
EventListener> T[]
getListeners(
Class<T>
listenerType) {
EventListener l = null;
if (
listenerType ==
WindowFocusListener.class) {
l =
windowFocusListener;
} else if (
listenerType ==
WindowStateListener.class) {
l =
windowStateListener;
} else if (
listenerType ==
WindowListener.class) {
l =
windowListener;
} else {
return super.getListeners(
listenerType);
}
return
AWTEventMulticaster.
getListeners(
l,
listenerType);
}
// REMIND: remove when filtering is handled at lower level
boolean
eventEnabled(
AWTEvent e) {
switch(
e.
id) {
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:
if ((
eventMask &
AWTEvent.
WINDOW_EVENT_MASK) != 0 ||
windowListener != null) {
return true;
}
return false;
case
WindowEvent.
WINDOW_GAINED_FOCUS:
case
WindowEvent.
WINDOW_LOST_FOCUS:
if ((
eventMask &
AWTEvent.
WINDOW_FOCUS_EVENT_MASK) != 0 ||
windowFocusListener != null) {
return true;
}
return false;
case
WindowEvent.
WINDOW_STATE_CHANGED:
if ((
eventMask &
AWTEvent.
WINDOW_STATE_EVENT_MASK) != 0 ||
windowStateListener != null) {
return true;
}
return false;
default:
break;
}
return super.eventEnabled(
e);
}
/**
* Processes events on this window. If the event is an
* {@code WindowEvent}, it invokes the
* {@code processWindowEvent} method, else it invokes its
* superclass's {@code processEvent}.
* <p>Note that if the event parameter is {@code 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);
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:
* <ul>
* <li>A WindowListener object is registered via
* {@code addWindowListener}
* <li>Window events are enabled via {@code enableEvents}
* </ul>
* <p>Note that if the event parameter is {@code 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 occurring 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:
* <ul>
* <li>a WindowFocusListener is registered via
* {@code addWindowFocusListener}
* <li>Window focus events are enabled via {@code enableEvents}
* </ul>
* <p>Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
* @param e the window focus event
* @see Component#enableEvents
* @since 1.4
*/
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 occurring on this window by
* dispatching them to any registered {@code 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:
* <ul>
* <li>a {@code WindowStateListener} is registered via
* {@code addWindowStateListener}
* <li>window state events are enabled via {@code enableEvents}
* </ul>
* <p>Note that if the event parameter is {@code 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 <i>control-shift-F1</i>. If so,
* the list of child windows is dumped to {@code 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
}
/**
* Sets whether this window should always be above other windows. If
* there are multiple always-on-top windows, their relative order is
* unspecified and platform dependent.
* <p>
* If some other window is already always-on-top then the
* relative order between these windows is unspecified (depends on
* platform). No window can be brought to be over the always-on-top
* window except maybe another always-on-top window.
* <p>
* All windows owned by an always-on-top window inherit this state and
* automatically become always-on-top. If a window ceases to be
* always-on-top, the windows that it owns will no longer be
* always-on-top. When an always-on-top window is sent {@link #toBack
* toBack}, its always-on-top state is set to {@code false}.
*
* <p> When this method is called on a window with a value of
* {@code true}, and the window is visible and the platform
* supports always-on-top for this window, the window is immediately
* brought forward, "sticking" it in the top-most position. If the
* window isn`t currently visible, this method sets the always-on-top
* state to {@code true} but does not bring the window forward.
* When the window is later shown, it will be always-on-top.
*
* <p> When this method is called on a window with a value of
* {@code false} the always-on-top state is set to normal. It may also
* cause an unspecified, platform-dependent change in the z-order of
* top-level windows, but other always-on-top windows will remain in
* top-most position. Calling this method with a value of {@code false}
* on a window that has a normal state has no effect.
*
* <p><b>Note</b>: some platforms might not support always-on-top
* windows. To detect if always-on-top windows are supported by the
* current platform, use {@link Toolkit#isAlwaysOnTopSupported()} and
* {@link Window#isAlwaysOnTopSupported()}. If always-on-top mode
* isn't supported for this window or this window's toolkit does not
* support always-on-top windows, calling this method has no effect.
* <p>
* 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 true if the window should always be above other
* windows
* @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
* @see #isAlwaysOnTopSupported
* @see #getToolkit
* @see Toolkit#isAlwaysOnTopSupported
* @since 1.5
*/
public final void
setAlwaysOnTop(boolean
alwaysOnTop) throws
SecurityException {
SecurityManager security =
System.
getSecurityManager();
if (
security != null) {
security.
checkPermission(
SecurityConstants.
AWT.
SET_WINDOW_ALWAYS_ON_TOP_PERMISSION);
}
boolean
oldAlwaysOnTop;
synchronized(this) {
oldAlwaysOnTop = this.
alwaysOnTop;
this.
alwaysOnTop =
alwaysOnTop;
}
if (
oldAlwaysOnTop !=
alwaysOnTop ) {
if (
isAlwaysOnTopSupported()) {
WindowPeer peer = (
WindowPeer)this.
peer;
synchronized(
getTreeLock()) {
if (
peer != null) {
peer.
updateAlwaysOnTopState();
}
}
}
firePropertyChange("alwaysOnTop",
oldAlwaysOnTop,
alwaysOnTop);
}
setOwnedWindowsAlwaysOnTop(
alwaysOnTop);
}
@
SuppressWarnings({"rawtypes", "unchecked"})
private void
setOwnedWindowsAlwaysOnTop(boolean
alwaysOnTop) {
WeakReference<
Window>[]
ownedWindowArray;
synchronized (
ownedWindowList) {
ownedWindowArray = new
WeakReference[
ownedWindowList.
size()];
ownedWindowList.
copyInto(
ownedWindowArray);
}
for (
WeakReference<
Window>
ref :
ownedWindowArray) {
Window window =
ref.
get();
if (
window != null) {
try {
window.
setAlwaysOnTop(
alwaysOnTop);
} catch (
SecurityException ignore) {
}
}
}
}
/**
* Returns whether the always-on-top mode is supported for this
* window. Some platforms may not support always-on-top windows, some
* may support only some kinds of top-level windows; for example,
* a platform may not support always-on-top modal dialogs.
*
* @return {@code true}, if the always-on-top mode is supported for
* this window and this window's toolkit supports always-on-top windows,
* {@code false} otherwise
*
* @see #setAlwaysOnTop(boolean)
* @see #getToolkit
* @see Toolkit#isAlwaysOnTopSupported
* @since 1.6
*/
public boolean
isAlwaysOnTopSupported() {
return
Toolkit.
getDefaultToolkit().
isAlwaysOnTopSupported();
}
/**
* Returns whether this window is an always-on-top window.
* @return {@code true}, if the window is in always-on-top state,
* {@code 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 {@code 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.
* <p>
* 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 {@code
* setFocusTraversalKeys} for a full description of each key.)
* <p>
* 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
*/
@
SuppressWarnings("unchecked")
public
Set<
AWTKeyStroke>
getFocusTraversalKeys(int
id) {
if (
id < 0 ||
id >=
KeyboardFocusManager.
TRAVERSAL_KEY_LENGTH) {
throw new
IllegalArgumentException("invalid focus traversal key identifier");
}
// Okay to return Set directly because it is an unmodifiable view
@
SuppressWarnings("rawtypes")
Set keystrokes = (
focusTraversalKeys != null)
?
focusTraversalKeys[
id]
: null;
if (
keystrokes != null) {
return
keystrokes;
} else {
return
KeyboardFocusManager.
getCurrentKeyboardFocusManager().
getDefaultFocusTraversalKeys(
id);
}
}
/**
* Does nothing because Windows must always be roots of a focus traversal
* cycle. The passed-in value is ignored.
*
* @param focusCycleRoot this value is ignored
* @see #isFocusCycleRoot
* @see Container#setFocusTraversalPolicy
* @see Container#getFocusTraversalPolicy
* @since 1.4
*/
public final void
setFocusCycleRoot(boolean
focusCycleRoot) {
}
/**
* Always returns {@code true} because all Windows must be roots of a
* focus traversal cycle.
*
* @return {@code true}
* @see #setFocusCycleRoot
* @see Container#setFocusTraversalPolicy
* @see Container#getFocusTraversalPolicy
* @since 1.4
*/
public final boolean
isFocusCycleRoot() {
return true;
}
/**
* Always returns {@code null} because Windows have no ancestors; they
* represent the top of the Component hierarchy.
*
* @return {@code 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 {@code true}. For a Window which is not a Frame or
* Dialog to be focusable, its focusable Window state must be set to
* {@code 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 {@code true} if this Window can be the focused Window;
* {@code 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 {@code isFocusableWindow}. If
* this method returns {@code false}, then
* {@code isFocusableWindow} will return {@code false} as well.
* If this method returns {@code true}, then
* {@code isFocusableWindow} may return {@code true} or
* {@code false} depending upon the other requirements which must be
* met in order for a Window to be focusable.
* <p>
* By default, all Windows have a focusable Window state of
* {@code 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 {@code isFocusableWindow}. If
* this Window's focusable Window state is set to {@code false}, then
* {@code isFocusableWindow} will return {@code false}. If this
* Window's focusable Window state is set to {@code true}, then
* {@code isFocusableWindow} may return {@code true} or
* {@code false} depending upon the other requirements which must be
* met in order for a Window to be focusable.
* <p>
* Setting a Window's focusability state to {@code 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 {@code Window}
* can have a delayed effect on some platforms the actual
* change may happen only when the {@code Window} becomes
* hidden and then visible again. To ensure consistent behavior
* across platforms, set the {@code Window}'s focusable state
* when the {@code 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;
}
WindowPeer peer = (
WindowPeer)this.
peer;
if (
peer != null) {
peer.
updateFocusableWindowState();
}
firePropertyChange("focusableWindowState",
oldFocusableWindowState,
focusableWindowState);
if (
oldFocusableWindowState && !
focusableWindowState &&
isFocused()) {
for (
Window owner =
getOwner();
owner != null;
owner =
owner.
getOwner())
{
Component toFocus =
KeyboardFocusManager.
getMostRecentFocusOwner(
owner);
if (
toFocus != null &&
toFocus.
requestFocus(false,
CausedFocusEvent.
Cause.
ACTIVATION)) {
return;
}
}
KeyboardFocusManager.
getCurrentKeyboardFocusManager().
clearGlobalFocusOwnerPriv();
}
}
/**
* Sets whether this window should receive focus on
* subsequently being shown (with a call to {@link #setVisible setVisible(true)}),
* or being moved to the front (with a call to {@link #toFront}).
* <p>
* Note that {@link #setVisible setVisible(true)} may be called indirectly
* (e.g. when showing an owner of the window makes the window to be shown).
* {@link #toFront} may also be called indirectly (e.g. when
* {@link #setVisible setVisible(true)} is called on already visible window).
* In all such cases this property takes effect as well.
* <p>
* The value of the property is not inherited by owned windows.
*
* @param autoRequestFocus whether this window should be focused on
* subsequently being shown or being moved to the front
* @see #isAutoRequestFocus
* @see #isFocusableWindow
* @see #setVisible
* @see #toFront
* @since 1.7
*/
public void
setAutoRequestFocus(boolean
autoRequestFocus) {
this.
autoRequestFocus =
autoRequestFocus;
}
/**
* Returns whether this window should receive focus on subsequently being shown
* (with a call to {@link #setVisible setVisible(true)}), or being moved to the front
* (with a call to {@link #toFront}).
* <p>
* By default, the window has {@code autoRequestFocus} value of {@code true}.
*
* @return {@code autoRequestFocus} value
* @see #setAutoRequestFocus
* @since 1.7
*/
public boolean
isAutoRequestFocus() {
return
autoRequestFocus;
}
/**
* Adds a PropertyChangeListener to the listener list. The listener is
* registered for all bound properties of this class, including the
* following:
* <ul>
* <li>this Window's font ("font")</li>
* <li>this Window's background color ("background")</li>
* <li>this Window's foreground color ("foreground")</li>
* <li>this Window's focusability ("focusable")</li>
* <li>this Window's focus traversal keys enabled state
* ("focusTraversalKeysEnabled")</li>
* <li>this Window's Set of FORWARD_TRAVERSAL_KEYS
* ("forwardFocusTraversalKeys")</li>
* <li>this Window's Set of BACKWARD_TRAVERSAL_KEYS
* ("backwardFocusTraversalKeys")</li>
* <li>this Window's Set of UP_CYCLE_TRAVERSAL_KEYS
* ("upCycleFocusTraversalKeys")</li>
* <li>this Window's Set of DOWN_CYCLE_TRAVERSAL_KEYS
* ("downCycleFocusTraversalKeys")</li>
* <li>this Window's focus traversal policy ("focusTraversalPolicy")
* </li>
* <li>this Window's focusable Window state ("focusableWindowState")
* </li>
* <li>this Window's always-on-top state("alwaysOnTop")</li>
* </ul>
* 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.
* <p>
* 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:
* <ul>
* <li>this Window's font ("font")</li>
* <li>this Window's background color ("background")</li>
* <li>this Window's foreground color ("foreground")</li>
* <li>this Window's focusability ("focusable")</li>
* <li>this Window's focus traversal keys enabled state
* ("focusTraversalKeysEnabled")</li>
* <li>this Window's Set of FORWARD_TRAVERSAL_KEYS
* ("forwardFocusTraversalKeys")</li>
* <li>this Window's Set of BACKWARD_TRAVERSAL_KEYS
* ("backwardFocusTraversalKeys")</li>
* <li>this Window's Set of UP_CYCLE_TRAVERSAL_KEYS
* ("upCycleFocusTraversalKeys")</li>
* <li>this Window's Set of DOWN_CYCLE_TRAVERSAL_KEYS
* ("downCycleFocusTraversalKeys")</li>
* <li>this Window's focus traversal policy ("focusTraversalPolicy")
* </li>
* <li>this Window's focusable Window state ("focusableWindowState")
* </li>
* <li>this Window's always-on-top state("alwaysOnTop")</li>
* </ul>
* 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.
* <p>
* 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);
}
/**
* Indicates if this container is a validate root.
* <p>
* {@code Window} objects are the validate roots, and, therefore, they
* override this method to return {@code true}.
*
* @return {@code true}
* @since 1.7
* @see java.awt.Container#isValidateRoot
*/
@
Override
public boolean
isValidateRoot() {
return true;
}
/**
* 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 {@code 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;
}
boolean
isDisposing() {
return
disposing;
}
/**
* @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,
Locale.
getDefault(),
ClassLoader.
getSystemClassLoader()));
}
/*
* Support for tracking all windows owned by this window
*/
void
addOwnedWindow(
WeakReference<
Window>
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<
Window>
weakWindow) {
if (
weakWindow != null) {
// synchronized block not required since removeElement is
// already synchronized
ownedWindowList.
removeElement(
weakWindow);
}
}
void
connectOwnedWindow(
Window child) {
child.
parent = this;
addOwnedWindow(
child.
weakThis);
child.
disposerRecord.
updateOwner();
}
private void
addToWindowList() {
synchronized (
Window.class) {
@
SuppressWarnings("unchecked")
Vector<
WeakReference<
Window>>
windowList = (
Vector<
WeakReference<
Window>>)
appContext.
get(
Window.class);
if (
windowList == null) {
windowList = new
Vector<
WeakReference<
Window>>();
appContext.
put(
Window.class,
windowList);
}
windowList.
add(
weakThis);
}
}
private static void
removeFromWindowList(
AppContext context,
WeakReference<
Window>
weakThis) {
synchronized (
Window.class) {
@
SuppressWarnings("unchecked")
Vector<
WeakReference<
Window>>
windowList = (
Vector<
WeakReference<
Window>>)
context.
get(
Window.class);
if (
windowList != null) {
windowList.
remove(
weakThis);
}
}
}
private void
removeFromWindowList() {
removeFromWindowList(
appContext,
weakThis);
}
/**
* Window type.
*
* Synchronization: ObjectLock
*/
private
Type type =
Type.
NORMAL;
/**
* Sets the type of the window.
*
* This method can only be called while the window is not displayable.
*
* @throws IllegalComponentStateException if the window
* is displayable.
* @throws IllegalArgumentException if the type is {@code null}
* @see Component#isDisplayable
* @see #getType
* @since 1.7
*/
public void
setType(
Type type) {
if (
type == null) {
throw new
IllegalArgumentException("type should not be null.");
}
synchronized (
getTreeLock()) {
if (
isDisplayable()) {
throw new
IllegalComponentStateException(
"The window is displayable.");
}
synchronized (
getObjectLock()) {
this.
type =
type;
}
}
}
/**
* Returns the type of the window.
*
* @see #setType
* @since 1.7
*/
public
Type getType() {
synchronized (
getObjectLock()) {
return
type;
}
}
/**
* The window serialized data version.
*
* @serial
*/
private int
windowSerializedDataVersion = 2;
/**
* Writes default serializable fields to stream. Writes
* a list of serializable {@code WindowListener}s and
* {@code WindowFocusListener}s as optional data.
* Writes a list of child windows as optional data.
* Writes a list of icon images as optional data
*
* @param s the {@code ObjectOutputStream} to write
* @serialData {@code null} terminated sequence of
* 0 or more pairs; the pair consists of a {@code String}
* and {@code Object}; the {@code String}
* indicates the type of object and is one of the following:
* {@code windowListenerK} indicating a
* {@code WindowListener} object;
* {@code windowFocusWindowK} indicating a
* {@code WindowFocusListener} object;
* {@code ownedWindowK} indicating a child
* {@code 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 =
ownedWindowList.
elementAt(
i).
get();
if (
child != null) {
s.
writeObject(
ownedWindowK);
s.
writeObject(
child);
}
}
}
s.
writeObject(null);
//write icon array
if (
icons != null) {
for (
Image i :
icons) {
if (
i instanceof
Serializable) {
s.
writeObject(
i);
}
}
}
s.
writeObject(null);
}
//
// Part of deserialization procedure to be called before
// user's code.
//
private void
initDeserializedWindow() {
setWarningString();
inputContextLock = new
Object();
// Deserialized Windows are not yet visible.
visible = false;
weakThis = new
WeakReference<>(this);
anchor = new
Object();
disposerRecord = new
WindowDisposerRecord(
appContext, this);
sun.java2d.
Disposer.
addRecord(
anchor,
disposerRecord);
addToWindowList();
initGC(null);
ownedWindowList = new
Vector<>();
}
private void
deserializeResources(
ObjectInputStream s)
throws
ClassNotFoundException,
IOException,
HeadlessException {
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;
}
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();
}
//read icons
Object obj =
s.
readObject(); //Throws OptionalDataException
//for pre1.6 objects.
icons = new
ArrayList<
Image>(); //Frame.readObject() assumes
//pre1.6 version if icons is null.
while (
obj != null) {
if (
obj instanceof
Image) {
icons.
add((
Image)
obj);
}
obj =
s.
readObject();
}
}
catch (
OptionalDataException e) {
// 1.1 serialized form
// ownedWindowList will be updated by Frame.readObject
}
}
/**
* Reads the {@code ObjectInputStream} and an optional
* list of listeners to receive various events fired by
* the component; also reads a list of
* (possibly {@code null}) child windows.
* Unrecognized keys or values will be ignored.
*
* @param s the {@code ObjectInputStream} to read
* @exception HeadlessException if
* {@code GraphicsEnvironment.isHeadless} returns
* {@code true}
* @see java.awt.GraphicsEnvironment#isHeadless
* @see #writeObject
*/
private void
readObject(
ObjectInputStream s)
throws
ClassNotFoundException,
IOException,
HeadlessException
{
GraphicsEnvironment.
checkHeadless();
initDeserializedWindow();
ObjectInputStream.
GetField f =
s.
readFields();
syncLWRequests =
f.
get("syncLWRequests",
systemSyncLWRequests);
state =
f.
get("state", 0);
focusableWindowState =
f.
get("focusableWindowState", true);
windowSerializedDataVersion =
f.
get("windowSerializedDataVersion", 1);
locationByPlatform =
f.
get("locationByPlatform",
locationByPlatformProp);
// Note: 1.4 (or later) doesn't use focusMgr
focusMgr = (
FocusManager)
f.
get("focusMgr", null);
Dialog.
ModalExclusionType et = (
Dialog.
ModalExclusionType)
f.
get("modalExclusionType",
Dialog.
ModalExclusionType.
NO_EXCLUDE);
setModalExclusionType(
et); // since 6.0
boolean
aot =
f.
get("alwaysOnTop", false);
if(
aot) {
setAlwaysOnTop(
aot); // since 1.5; subject to permission check
}
shape = (
Shape)
f.
get("shape", null);
opacity = (
Float)
f.
get("opacity", 1.0f);
this.
securityWarningWidth = 0;
this.
securityWarningHeight = 0;
this.
securityWarningPointX = 2.0;
this.
securityWarningPointY = 0.0;
this.
securityWarningAlignmentX =
RIGHT_ALIGNMENT;
this.
securityWarningAlignmentY =
TOP_ALIGNMENT;
deserializeResources(
s);
}
/*
* --- 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
* @since 1.3
*/
public
AccessibleContext getAccessibleContext() {
if (
accessibleContext == null) {
accessibleContext = new
AccessibleAWTWindow();
}
return
accessibleContext;
}
/**
* This class implements accessibility support for the
* {@code Window} class. It provides an implementation of the
* Java Accessibility API appropriate to window user-interface elements.
* @since 1.3
*/
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
@
Override
void
setGraphicsConfiguration(
GraphicsConfiguration gc) {
if (
gc == null) {
gc =
GraphicsEnvironment.
getLocalGraphicsEnvironment().
getDefaultScreenDevice().
getDefaultConfiguration();
}
synchronized (
getTreeLock()) {
super.setGraphicsConfiguration(
gc);
if (
log.
isLoggable(
PlatformLogger.
Level.
FINER)) {
log.
finer("+ Window.setGraphicsConfiguration(): new GC is \n+ " +
getGraphicsConfiguration_NoClientCode() + "\n+ this is " + this);
}
}
}
/**
* Sets the location of the window relative to the specified
* component according to the following scenarios.
* <p>
* The target screen mentioned below is a screen to which
* the window should be placed after the setLocationRelativeTo
* method is called.
* <ul>
* <li>If the component is {@code null}, or the {@code
* GraphicsConfiguration} associated with this component is
* {@code null}, the window is placed in the center of the
* screen. The center point can be obtained with the {@link
* GraphicsEnvironment#getCenterPoint
* GraphicsEnvironment.getCenterPoint} method.
* <li>If the component is not {@code null}, but it is not
* currently showing, the window is placed in the center of
* the target screen defined by the {@code
* GraphicsConfiguration} associated with this component.
* <li>If the component is not {@code null} and is shown on
* the screen, then the window is located in such a way that
* the center of the window coincides with the center of the
* component.
* </ul>
* <p>
* If the screens configuration does not allow the window to
* be moved from one screen to another, then the window is
* only placed at the location determined according to the
* above conditions and its {@code GraphicsConfiguration} is
* not changed.
* <p>
* <b>Note</b>: If the lower edge of the window is out of the screen,
* then the window is placed to the side of the {@code 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 vice versa.
* <p>
* If after the window location has been calculated, the upper,
* left, or right edge of the window is out of the screen,
* then the window is located in such a way that the upper,
* left, or right edge of the window coincides with the
* corresponding edge of the screen. If both left and right
* edges of the window are out of the screen, the window is
* placed at the left side of the screen. The similar placement
* will occur if both top and bottom edges are out of the screen.
* In that case, the window is placed at the top side of the screen.
* <p>
* The method changes the geometry-related data. Therefore,
* the native windowing system may ignore such requests, or it may modify
* the requested data, so that the {@code Window} object is placed and sized
* in a way that corresponds closely to the desktop settings.
*
* @param c the component in relation to which the window's location
* is determined
* @see java.awt.GraphicsEnvironment#getCenterPoint
* @since 1.4
*/
public void
setLocationRelativeTo(
Component c) {
// target location
int
dx = 0,
dy = 0;
// target GC
GraphicsConfiguration gc =
getGraphicsConfiguration_NoClientCode();
Rectangle gcBounds =
gc.
getBounds();
Dimension windowSize =
getSize();
// search a top-level of c
Window componentWindow =
SunToolkit.
getContainingWindow(
c);
if ((
c == null) || (
componentWindow == null)) {
GraphicsEnvironment ge =
GraphicsEnvironment.
getLocalGraphicsEnvironment();
gc =
ge.
getDefaultScreenDevice().
getDefaultConfiguration();
gcBounds =
gc.
getBounds();
Point centerPoint =
ge.
getCenterPoint();
dx =
centerPoint.
x -
windowSize.
width / 2;
dy =
centerPoint.
y -
windowSize.
height / 2;
} else if (!
c.
isShowing()) {
gc =
componentWindow.
getGraphicsConfiguration();
gcBounds =
gc.
getBounds();
dx =
gcBounds.
x + (
gcBounds.
width -
windowSize.
width) / 2;
dy =
gcBounds.
y + (
gcBounds.
height -
windowSize.
height) / 2;
} else {
gc =
componentWindow.
getGraphicsConfiguration();
gcBounds =
gc.
getBounds();
Dimension compSize =
c.
getSize();
Point compLocation =
c.
getLocationOnScreen();
dx =
compLocation.
x + ((
compSize.
width -
windowSize.
width) / 2);
dy =
compLocation.
y + ((
compSize.
height -
windowSize.
height) / 2);
// Adjust for bottom edge being offscreen
if (
dy +
windowSize.
height >
gcBounds.
y +
gcBounds.
height) {
dy =
gcBounds.
y +
gcBounds.
height -
windowSize.
height;
if (
compLocation.
x -
gcBounds.
x +
compSize.
width / 2 <
gcBounds.
width / 2) {
dx =
compLocation.
x +
compSize.
width;
} else {
dx =
compLocation.
x -
windowSize.
width;
}
}
}
// Avoid being placed off the edge of the screen:
// bottom
if (
dy +
windowSize.
height >
gcBounds.
y +
gcBounds.
height) {
dy =
gcBounds.
y +
gcBounds.
height -
windowSize.
height;
}
// top
if (
dy <
gcBounds.
y) {
dy =
gcBounds.
y;
}
// right
if (
dx +
windowSize.
width >
gcBounds.
x +
gcBounds.
width) {
dx =
gcBounds.
x +
gcBounds.
width -
windowSize.
width;
}
// left
if (
dx <
gcBounds.
x) {
dx =
gcBounds.
x;
}
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 {@code 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.
* <p>
* 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).
* <p>
* 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 {@code 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 {@code null}
* @see #getBufferStrategy
* @since 1.4
*/
public void
createBufferStrategy(int
numBuffers,
BufferCapabilities caps) throws
AWTException {
super.createBufferStrategy(
numBuffers,
caps);
}
/**
* Returns the {@code BufferStrategy} used by this component. This
* method will return null if a {@code BufferStrategy} has not yet
* been created or has been disposed.
*
* @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.
canBeFocusOwner()) {
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 volatile 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
* {@code 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.
* <p>
* This behavior can also be enabled by setting the System Property
* "java.awt.Window.locationByPlatform" to "true", though calls to this method
* take precedence.
* <p>
* Calls to {@code setVisible}, {@code setLocation} and
* {@code setBounds} after calling {@code setLocationByPlatform} clear
* this property of the Window.
* <p>
* For example, after the following code is executed:
* <pre>
* setLocationByPlatform(true);
* setVisible(true);
* boolean flag = isLocationByPlatform();
* </pre>
* The window will be shown at platform's default location and
* {@code flag} will be {@code false}.
* <p>
* In the following sample:
* <pre>
* setLocationByPlatform(true);
* setLocation(10, 10);
* boolean flag = isLocationByPlatform();
* setVisible(true);
* </pre>
* The window will be shown at (10, 10) and {@code flag} will be
* {@code false}.
*
* @param locationByPlatform {@code true} if this Window should appear
* at the default location, {@code false} if at the current location
* @throws IllegalComponentStateException if the window
* is showing on screen and locationByPlatform is {@code 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 {@code 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 {@code 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() {
return
locationByPlatform;
}
/**
* {@inheritDoc}
* <p>
* The {@code width} or {@code height} values
* are automatically enlarged if either is less than
* the minimum size as specified by previous call to
* {@code setMinimumSize}.
* <p>
* The method changes the geometry-related data. Therefore,
* the native windowing system may ignore such requests, or it may modify
* the requested data, so that the {@code Window} object is placed and sized
* in a way that corresponds closely to the desktop settings.
*
* @see #getBounds
* @see #setLocation(int, int)
* @see #setLocation(Point)
* @see #setSize(int, int)
* @see #setSize(Dimension)
* @see #setMinimumSize
* @see #setLocationByPlatform
* @see #isLocationByPlatform
* @since 1.6
*/
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);
}
}
/**
* {@inheritDoc}
* <p>
* The {@code r.width} or {@code r.height} values
* will be automatically enlarged if either is less than
* the minimum size as specified by previous call to
* {@code setMinimumSize}.
* <p>
* The method changes the geometry-related data. Therefore,
* the native windowing system may ignore such requests, or it may modify
* the requested data, so that the {@code Window} object is placed and sized
* in a way that corresponds closely to the desktop settings.
*
* @see #getBounds
* @see #setLocation(int, int)
* @see #setLocation(Point)
* @see #setSize(int, int)
* @see #setSize(Dimension)
* @see #setMinimumSize
* @see #setLocationByPlatform
* @see #isLocationByPlatform
* @since 1.6
*/
public void
setBounds(
Rectangle r) {
setBounds(
r.
x,
r.
y,
r.
width,
r.
height);
}
/**
* Determines whether this component will be displayed on the screen.
* @return {@code true} if the component and all of its ancestors
* until a toplevel window are visible, {@code false} otherwise
*/
boolean
isRecursivelyVisible() {
// 5079694 fix: for a toplevel to be displayed, its parent doesn't have to be visible.
// We're overriding isRecursivelyVisible to implement this policy.
return
visible;
}
// ******************** SHAPES & TRANSPARENCY CODE ********************
/**
* Returns the opacity of the window.
*
* @return the opacity of the window
*
* @see Window#setOpacity(float)
* @see GraphicsDevice.WindowTranslucency
*
* @since 1.7
*/
public float
getOpacity() {
return
opacity;
}
/**
* Sets the opacity of the window.
* <p>
* The opacity value is in the range [0..1]. Note that setting the opacity
* level of 0 may or may not disable the mouse event handling on this
* window. This is a platform-dependent behavior.
* <p>
* The following conditions must be met in order to set the opacity value
* less than {@code 1.0f}:
* <ul>
* <li>The {@link GraphicsDevice.WindowTranslucency#TRANSLUCENT TRANSLUCENT}
* translucency must be supported by the underlying system
* <li>The window must be undecorated (see {@link Frame#setUndecorated}
* and {@link Dialog#setUndecorated})
* <li>The window must not be in full-screen mode (see {@link
* GraphicsDevice#setFullScreenWindow(Window)})
* </ul>
* <p>
* If the requested opacity value is less than {@code 1.0f}, and any of the
* above conditions are not met, the window opacity will not change,
* and the {@code IllegalComponentStateException} will be thrown.
* <p>
* The translucency levels of individual pixels may also be effected by the
* alpha component of their color (see {@link Window#setBackground(Color)}) and the
* current shape of this window (see {@link #setShape(Shape)}).
*
* @param opacity the opacity level to set to the window
*
* @throws IllegalArgumentException if the opacity is out of the range
* [0..1]
* @throws IllegalComponentStateException if the window is decorated and
* the opacity is less than {@code 1.0f}
* @throws IllegalComponentStateException if the window is in full screen
* mode, and the opacity is less than {@code 1.0f}
* @throws UnsupportedOperationException if the {@code
* GraphicsDevice.WindowTranslucency#TRANSLUCENT TRANSLUCENT}
* translucency is not supported and the opacity is less than
* {@code 1.0f}
*
* @see Window#getOpacity
* @see Window#setBackground(Color)
* @see Window#setShape(Shape)
* @see Frame#isUndecorated
* @see Dialog#isUndecorated
* @see GraphicsDevice.WindowTranslucency
* @see GraphicsDevice#isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)
*
* @since 1.7
*/
public void
setOpacity(float
opacity) {
synchronized (
getTreeLock()) {
if (
opacity < 0.0f ||
opacity > 1.0f) {
throw new
IllegalArgumentException(
"The value of opacity should be in the range [0.0f .. 1.0f].");
}
if (
opacity < 1.0f) {
GraphicsConfiguration gc =
getGraphicsConfiguration();
GraphicsDevice gd =
gc.
getDevice();
if (
gc.
getDevice().
getFullScreenWindow() == this) {
throw new
IllegalComponentStateException(
"Setting opacity for full-screen window is not supported.");
}
if (!
gd.
isWindowTranslucencySupported(
GraphicsDevice.
WindowTranslucency.
TRANSLUCENT))
{
throw new
UnsupportedOperationException(
"TRANSLUCENT translucency is not supported.");
}
}
this.
opacity =
opacity;
WindowPeer peer = (
WindowPeer)
getPeer();
if (
peer != null) {
peer.
setOpacity(
opacity);
}
}
}
/**
* Returns the shape of the window.
*
* The value returned by this method may not be the same as
* previously set with {@code setShape(shape)}, but it is guaranteed
* to represent the same shape.
*
* @return the shape of the window or {@code null} if no
* shape is specified for the window
*
* @see Window#setShape(Shape)
* @see GraphicsDevice.WindowTranslucency
*
* @since 1.7
*/
public
Shape getShape() {
synchronized (
getTreeLock()) {
return
shape == null ? null : new
Path2D.
Float(
shape);
}
}
/**
* Sets the shape of the window.
* <p>
* Setting a shape cuts off some parts of the window. Only the parts that
* belong to the given {@link Shape} remain visible and clickable. If
* the shape argument is {@code null}, this method restores the default
* shape, making the window rectangular on most platforms.
* <p>
* The following conditions must be met to set a non-null shape:
* <ul>
* <li>The {@link GraphicsDevice.WindowTranslucency#PERPIXEL_TRANSPARENT
* PERPIXEL_TRANSPARENT} translucency must be supported by the
* underlying system
* <li>The window must be undecorated (see {@link Frame#setUndecorated}
* and {@link Dialog#setUndecorated})
* <li>The window must not be in full-screen mode (see {@link
* GraphicsDevice#setFullScreenWindow(Window)})
* </ul>
* <p>
* If the requested shape is not {@code null}, and any of the above
* conditions are not met, the shape of this window will not change,
* and either the {@code UnsupportedOperationException} or {@code
* IllegalComponentStateException} will be thrown.
* <p>
* The translucency levels of individual pixels may also be effected by the
* alpha component of their color (see {@link Window#setBackground(Color)}) and the
* opacity value (see {@link #setOpacity(float)}). See {@link
* GraphicsDevice.WindowTranslucency} for more details.
*
* @param shape the shape to set to the window
*
* @throws IllegalComponentStateException if the shape is not {@code
* null} and the window is decorated
* @throws IllegalComponentStateException if the shape is not {@code
* null} and the window is in full-screen mode
* @throws UnsupportedOperationException if the shape is not {@code
* null} and {@link GraphicsDevice.WindowTranslucency#PERPIXEL_TRANSPARENT
* PERPIXEL_TRANSPARENT} translucency is not supported
*
* @see Window#getShape()
* @see Window#setBackground(Color)
* @see Window#setOpacity(float)
* @see Frame#isUndecorated
* @see Dialog#isUndecorated
* @see GraphicsDevice.WindowTranslucency
* @see GraphicsDevice#isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)
*
* @since 1.7
*/
public void
setShape(
Shape shape) {
synchronized (
getTreeLock()) {
if (
shape != null) {
GraphicsConfiguration gc =
getGraphicsConfiguration();
GraphicsDevice gd =
gc.
getDevice();
if (
gc.
getDevice().
getFullScreenWindow() == this) {
throw new
IllegalComponentStateException(
"Setting shape for full-screen window is not supported.");
}
if (!
gd.
isWindowTranslucencySupported(
GraphicsDevice.
WindowTranslucency.
PERPIXEL_TRANSPARENT))
{
throw new
UnsupportedOperationException(
"PERPIXEL_TRANSPARENT translucency is not supported.");
}
}
this.
shape = (
shape == null) ? null : new
Path2D.
Float(
shape);
WindowPeer peer = (
WindowPeer)
getPeer();
if (
peer != null) {
peer.
applyShape(
shape == null ? null :
Region.
getInstance(
shape, null));
}
}
}
/**
* Gets the background color of this window.
* <p>
* Note that the alpha component of the returned color indicates whether
* the window is in the non-opaque (per-pixel translucent) mode.
*
* @return this component's background color
*
* @see Window#setBackground(Color)
* @see Window#isOpaque
* @see GraphicsDevice.WindowTranslucency
*/
@
Override
public
Color getBackground() {
return super.getBackground();
}
/**
* Sets the background color of this window.
* <p>
* If the windowing system supports the {@link
* GraphicsDevice.WindowTranslucency#PERPIXEL_TRANSLUCENT PERPIXEL_TRANSLUCENT}
* translucency, the alpha component of the given background color
* may effect the mode of operation for this window: it indicates whether
* this window must be opaque (alpha equals {@code 1.0f}) or per-pixel translucent
* (alpha is less than {@code 1.0f}). If the given background color is
* {@code null}, the window is considered completely opaque.
* <p>
* All the following conditions must be met to enable the per-pixel
* transparency mode for this window:
* <ul>
* <li>The {@link GraphicsDevice.WindowTranslucency#PERPIXEL_TRANSLUCENT
* PERPIXEL_TRANSLUCENT} translucency must be supported by the graphics
* device where this window is located
* <li>The window must be undecorated (see {@link Frame#setUndecorated}
* and {@link Dialog#setUndecorated})
* <li>The window must not be in full-screen mode (see {@link
* GraphicsDevice#setFullScreenWindow(Window)})
* </ul>
* <p>
* If the alpha component of the requested background color is less than
* {@code 1.0f}, and any of the above conditions are not met, the background
* color of this window will not change, the alpha component of the given
* background color will not affect the mode of operation for this window,
* and either the {@code UnsupportedOperationException} or {@code
* IllegalComponentStateException} will be thrown.
* <p>
* When the window is per-pixel translucent, the drawing sub-system
* respects the alpha value of each individual pixel. If a pixel gets
* painted with the alpha color component equal to zero, it becomes
* visually transparent. If the alpha of the pixel is equal to 1.0f, the
* pixel is fully opaque. Interim values of the alpha color component make
* the pixel semi-transparent. In this mode, the background of the window
* gets painted with the alpha value of the given background color. If the
* alpha value of the argument of this method is equal to {@code 0}, the
* background is not painted at all.
* <p>
* The actual level of translucency of a given pixel also depends on window
* opacity (see {@link #setOpacity(float)}), as well as the current shape of
* this window (see {@link #setShape(Shape)}).
* <p>
* Note that painting a pixel with the alpha value of {@code 0} may or may
* not disable the mouse event handling on this pixel. This is a
* platform-dependent behavior. To make sure the mouse events do not get
* dispatched to a particular pixel, the pixel must be excluded from the
* shape of the window.
* <p>
* Enabling the per-pixel translucency mode may change the graphics
* configuration of this window due to the native platform requirements.
*
* @param bgColor the color to become this window's background color.
*
* @throws IllegalComponentStateException if the alpha value of the given
* background color is less than {@code 1.0f} and the window is decorated
* @throws IllegalComponentStateException if the alpha value of the given
* background color is less than {@code 1.0f} and the window is in
* full-screen mode
* @throws UnsupportedOperationException if the alpha value of the given
* background color is less than {@code 1.0f} and {@link
* GraphicsDevice.WindowTranslucency#PERPIXEL_TRANSLUCENT
* PERPIXEL_TRANSLUCENT} translucency is not supported
*
* @see Window#getBackground
* @see Window#isOpaque
* @see Window#setOpacity(float)
* @see Window#setShape(Shape)
* @see Frame#isUndecorated
* @see Dialog#isUndecorated
* @see GraphicsDevice.WindowTranslucency
* @see GraphicsDevice#isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)
* @see GraphicsConfiguration#isTranslucencyCapable()
*/
@
Override
public void
setBackground(
Color bgColor) {
Color oldBg =
getBackground();
super.setBackground(
bgColor);
if (
oldBg != null &&
oldBg.
equals(
bgColor)) {
return;
}
int
oldAlpha =
oldBg != null ?
oldBg.
getAlpha() : 255;
int
alpha =
bgColor != null ?
bgColor.
getAlpha() : 255;
if ((
oldAlpha == 255) && (
alpha < 255)) { // non-opaque window
GraphicsConfiguration gc =
getGraphicsConfiguration();
GraphicsDevice gd =
gc.
getDevice();
if (
gc.
getDevice().
getFullScreenWindow() == this) {
throw new
IllegalComponentStateException(
"Making full-screen window non opaque is not supported.");
}
if (!
gc.
isTranslucencyCapable()) {
GraphicsConfiguration capableGC =
gd.
getTranslucencyCapableGC();
if (
capableGC == null) {
throw new
UnsupportedOperationException(
"PERPIXEL_TRANSLUCENT translucency is not supported");
}
setGraphicsConfiguration(
capableGC);
}
setLayersOpaque(this, false);
} else if ((
oldAlpha < 255) && (
alpha == 255)) {
setLayersOpaque(this, true);
}
WindowPeer peer = (
WindowPeer)
getPeer();
if (
peer != null) {
peer.
setOpaque(
alpha == 255);
}
}
/**
* Indicates if the window is currently opaque.
* <p>
* The method returns {@code false} if the background color of the window
* is not {@code null} and the alpha component of the color is less than
* {@code 1.0f}. The method returns {@code true} otherwise.
*
* @return {@code true} if the window is opaque, {@code false} otherwise
*
* @see Window#getBackground
* @see Window#setBackground(Color)
* @since 1.7
*/
@
Override
public boolean
isOpaque() {
Color bg =
getBackground();
return
bg != null ?
bg.
getAlpha() == 255 : true;
}
private void
updateWindow() {
synchronized (
getTreeLock()) {
WindowPeer peer = (
WindowPeer)
getPeer();
if (
peer != null) {
peer.
updateWindow();
}
}
}
/**
* {@inheritDoc}
*
* @since 1.7
*/
@
Override
public void
paint(
Graphics g) {
if (!
isOpaque()) {
Graphics gg =
g.
create();
try {
if (
gg instanceof
Graphics2D) {
gg.
setColor(
getBackground());
((
Graphics2D)
gg).
setComposite(
AlphaComposite.
getInstance(
AlphaComposite.
SRC));
gg.
fillRect(0, 0,
getWidth(),
getHeight());
}
} finally {
gg.
dispose();
}
}
super.paint(
g);
}
private static void
setLayersOpaque(
Component component, boolean
isOpaque) {
// Shouldn't use instanceof to avoid loading Swing classes
// if it's a pure AWT application.
if (
SunToolkit.
isInstanceOf(
component, "javax.swing.RootPaneContainer")) {
javax.swing.
RootPaneContainer rpc = (javax.swing.
RootPaneContainer)
component;
javax.swing.
JRootPane root =
rpc.
getRootPane();
javax.swing.
JLayeredPane lp =
root.
getLayeredPane();
Container c =
root.
getContentPane();
javax.swing.
JComponent content =
(
c instanceof javax.swing.
JComponent) ? (javax.swing.
JComponent)
c : null;
lp.
setOpaque(
isOpaque);
root.
setOpaque(
isOpaque);
if (
content != null) {
content.
setOpaque(
isOpaque);
// Iterate down one level to see whether we have a JApplet
// (which is also a RootPaneContainer) which requires processing
int
numChildren =
content.
getComponentCount();
if (
numChildren > 0) {
Component child =
content.
getComponent(0);
// It's OK to use instanceof here because we've
// already loaded the RootPaneContainer class by now
if (
child instanceof javax.swing.
RootPaneContainer) {
setLayersOpaque(
child,
isOpaque);
}
}
}
}
}
// ************************** MIXING CODE *******************************
// A window has an owner, but it does NOT have a container
@
Override
final
Container getContainer() {
return null;
}
/**
* Applies the shape to the component
* @param shape Shape to be applied to the component
*/
@
Override
final void
applyCompoundShape(
Region shape) {
// The shape calculated by mixing code is not intended to be applied
// to windows or frames
}
@
Override
final void
applyCurrentShape() {
// The shape calculated by mixing code is not intended to be applied
// to windows or frames
}
@
Override
final void
mixOnReshaping() {
// The shape calculated by mixing code is not intended to be applied
// to windows or frames
}
@
Override
final
Point getLocationOnWindow() {
return new
Point(0, 0);
}
// ****************** END OF MIXING CODE ********************************
/**
* Limit the given double value with the given range.
*/
private static double
limit(double
value, double
min, double
max) {
value =
Math.
max(
value,
min);
value =
Math.
min(
value,
max);
return
value;
}
/**
* Calculate the position of the security warning.
*
* This method gets the window location/size as reported by the native
* system since the locally cached values may represent outdated data.
*
* The method is used from the native code, or via AWTAccessor.
*
* NOTE: this method is invoked on the toolkit thread, and therefore is not
* supposed to become public/user-overridable.
*/
private
Point2D calculateSecurityWarningPosition(double
x, double
y,
double
w, double
h)
{
// The position according to the spec of SecurityWarning.setPosition()
double
wx =
x +
w *
securityWarningAlignmentX +
securityWarningPointX;
double
wy =
y +
h *
securityWarningAlignmentY +
securityWarningPointY;
// First, make sure the warning is not too far from the window bounds
wx =
Window.
limit(
wx,
x -
securityWarningWidth - 2,
x +
w + 2);
wy =
Window.
limit(
wy,
y -
securityWarningHeight - 2,
y +
h + 2);
// Now make sure the warning window is visible on the screen
GraphicsConfiguration graphicsConfig =
getGraphicsConfiguration_NoClientCode();
Rectangle screenBounds =
graphicsConfig.
getBounds();
Insets screenInsets =
Toolkit.
getDefaultToolkit().
getScreenInsets(
graphicsConfig);
wx =
Window.
limit(
wx,
screenBounds.
x +
screenInsets.
left,
screenBounds.
x +
screenBounds.
width -
screenInsets.
right
-
securityWarningWidth);
wy =
Window.
limit(
wy,
screenBounds.
y +
screenInsets.
top,
screenBounds.
y +
screenBounds.
height -
screenInsets.
bottom
-
securityWarningHeight);
return new
Point2D.
Double(
wx,
wy);
}
static {
AWTAccessor.
setWindowAccessor(new
AWTAccessor.
WindowAccessor() {
public float
getOpacity(
Window window) {
return
window.
opacity;
}
public void
setOpacity(
Window window, float
opacity) {
window.
setOpacity(
opacity);
}
public
Shape getShape(
Window window) {
return
window.
getShape();
}
public void
setShape(
Window window,
Shape shape) {
window.
setShape(
shape);
}
public void
setOpaque(
Window window, boolean
opaque) {
Color bg =
window.
getBackground();
if (
bg == null) {
bg = new
Color(0, 0, 0, 0);
}
window.
setBackground(new
Color(
bg.
getRed(),
bg.
getGreen(),
bg.
getBlue(),
opaque ? 255 : 0));
}
public void
updateWindow(
Window window) {
window.
updateWindow();
}
public
Dimension getSecurityWarningSize(
Window window) {
return new
Dimension(
window.
securityWarningWidth,
window.
securityWarningHeight);
}
public void
setSecurityWarningSize(
Window window, int
width, int
height)
{
window.
securityWarningWidth =
width;
window.
securityWarningHeight =
height;
}
public void
setSecurityWarningPosition(
Window window,
Point2D point, float
alignmentX, float
alignmentY)
{
window.
securityWarningPointX =
point.
getX();
window.
securityWarningPointY =
point.
getY();
window.
securityWarningAlignmentX =
alignmentX;
window.
securityWarningAlignmentY =
alignmentY;
synchronized (
window.
getTreeLock()) {
WindowPeer peer = (
WindowPeer)
window.
getPeer();
if (
peer != null) {
peer.
repositionSecurityWarning();
}
}
}
public
Point2D calculateSecurityWarningPosition(
Window window,
double
x, double
y, double
w, double
h)
{
return
window.
calculateSecurityWarningPosition(
x,
y,
w,
h);
}
public void
setLWRequestStatus(
Window changed, boolean
status) {
changed.
syncLWRequests =
status;
}
public boolean
isAutoRequestFocus(
Window w) {
return
w.
autoRequestFocus;
}
public boolean
isTrayIconWindow(
Window w) {
return
w.
isTrayIconWindow;
}
public void
setTrayIconWindow(
Window w, boolean
isTrayIconWindow) {
w.
isTrayIconWindow =
isTrayIconWindow;
}
public
Window[]
getOwnedWindows(
Window w) {
return
w.
getOwnedWindows_NoClientCode();
}
}); // WindowAccessor
} // static
// a window doesn't need to be updated in the Z-order.
@
Override
void
updateZOrder() {}
} // 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;
}