--- old/src/java.desktop/share/classes/java/awt/doc-files/Modality.html 2017-10-23 13:51:03.000000000 -0700 +++ new/src/java.desktop/share/classes/java/awt/doc-files/Modality.html 2017-10-23 13:51:03.000000000 -0700 @@ -1,5 +1,11 @@ + + +
+ +This document, together with the API documentation for modality-related @@ -53,7 +49,7 @@
@@ -63,7 +59,7 @@ Every window belongs to some document — its root can be found as the closest ancestor window without an owner.
- + Modal blocked window - a window, that:
@@ -87,7 +83,7 @@ then all its owned windows and child components are also excluded.
Warning! Some window managers allow users to change the window - Z-order in an arbitrary way — in that case the last requirement + Z-order in an arbitrary way — in that case the last requirement may not be met.
Scope of blocking (SB) - the set of windows (instances of
- java.awt.Window and all derived classes) that are blocked by
+ java.awt.Window and all derived classes) that are blocked by
the modal dialog while it is visible.
- +
Note: Everywhere in this document the notion of "window" is equal @@ -95,7 +91,7 @@ an instance ofjava.awt.Windowor any descendant class.
@@ -159,7 +155,7 @@ dialog may have no effect until it is hidden and then shown again.
@@ -171,7 +167,7 @@
Showing the modal dialog: "M"
When modal dialog M is shown, all the visible windows fall into one of
- three distinct groups:
+ three distinct groups:
@@ -290,7 +286,7 @@ may have no effect until it is hidden and then shown again. - +
@@ -333,21 +329,21 @@
A special AWTPermission, "toolkitModality",
is required to show toolkit-modal
- dialogs. This would prevent, for example, blocking a browser or
+ dialogs. This would prevent, for example, blocking a browser or
Java Web Start (JWS) by modal dialogs shown from applets.
The same permission is required to exclude a window from toolkit modality. This would prevent, for example, a dialog shown from an applet not to be blocked by a browser's or JWS's modal dialog. - +
@@ -366,18 +362,18 @@ and a window is marked as E-excluded, this has no effect.
The default modality type is application-modal. It is used by the API
- calls: Dialog.setModal(true),
+ calls: Dialog.setModal(true),
Dialog(owner, true), etc. Prior to JDK 6
the default type was toolkit-modal,
but the only distinction between application- and toolkit-modality is for
applets and applications launched from Java Web Start.
-
+