--- old/src/java.desktop/share/classes/java/awt/doc-files/Modality.html 2018-11-28 17:08:42.540578108 +0530 +++ new/src/java.desktop/share/classes/java/awt/doc-files/Modality.html 2018-11-28 17:08:42.120788109 +0530 @@ -3,6 +3,10 @@ The AWT Modality + -

+ - - - - - - + + + + + + - - - - - - + + + + + + - - - - - - + + + + + + - - - - - - + + + + + + - - - - - - + + + + + + -
The Standard Blocking Matrix
current/shownframe & modelessdocumentapplicationtoolkit
current/shownframe & modelessdocumentapplicationtoolkit
-----
-----
documentblocked---
documentblocked---
applicationblockedblocked--
applicationblockedblocked--
toolkitblockedblockedblocked-
toolkitblockedblockedblocked-
- + +

After the modal dialog is shown, all the windows from its SB are blocked, except those that block this modal dialog. @@ -378,43 +380,43 @@ - - - - - - - -
+
  1. Frame "F" is shown
  2. Document-modal dialog "Di" is shown
  3. F becomes blocked by Di — it's in the same document
  4. Document-modal dialog "Dii" is shown
  5. Di becomes blocked by Dii — it's in the - same document
    + same document

+ Example 1
+
  1. Frame "F" is shown
  2. Document-modal dialog "Di" is shown
  3. F becomes blocked by Di — it's in the same document
  4. Document-modal dialog "Dii" is shown
  5. Di becomes blocked by Dii — - it's in the same document
    + it's in the same document
  6. Di is hidden
  7. F becomes blocked by Dii — it's in the same document

+ Example 2
+
  1. Frame "F" is shown
  2. Toolkit-modal dialog "Di" is created, but not shown
    @@ -422,37 +424,37 @@
  3. F becomes blocked by Dii — it's in the same document
  4. Application-modal dialog "Diii" is shown
  5. Dii becomes blocked by Diii — - it's in the same application
    + it's in the same application
  6. Di is shown
  7. Di becomes blocked by Dii — it's its owner
  8. Diii remains unblocked — it blocks Dii and - Dii blocks Di
    + Dii blocks Di

+ Example 3
-
    +
+
  1. Frame "F" is shown
  2. Toolkit-modal dialog "Di" is created, but not shown
  3. Document-modal dialog "Dii" is shown
  4. F becomes blocked by Dii — it's in the same document
  5. Application-modal dialog "Diii" is shown
  6. Dii becomes blocked by Diii — it's in the - same application
    + same application
  7. Di is shown
  8. Diii becomes blocked by Di — Di - is not blocked
    + is not blocked
  9. Di remains unblocked

+ Example 4