< prev index next >

src/java.desktop/share/classes/java/awt/doc-files/Modality.html

Print this page




  18  particular file as subject to the "Classpath" exception as provided
  19  by Oracle in the LICENSE file that accompanied this code.
  20 
  21  This code is distributed in the hope that it will be useful, but WITHOUT
  22  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  23  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  24  version 2 for more details (a copy is included in the LICENSE file that
  25  accompanied this code).
  26 
  27  You should have received a copy of the GNU General Public License version
  28  2 along with this work; if not, write to the Free Software Foundation,
  29  Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  30 
  31  Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  32  or visit www.oracle.com if you need additional information or have any
  33  questions.
  34 -->
  35 
  36 <body>
  37 <main role="main">

  38     <h1>The AWT Modality</h1>
  39 
  40     <p>
  41       This document, together with the API documentation for modality-related
  42       classes (such as <code>java.awt.Dialog</code>), briefly describes the new
  43       modality features and how to use them. It contains the following sections:
  44     </p><ul>
  45       <li><a href="#Definitions">Definitions</a></li>
  46       <li><a href="#ModalityTypes">Modality types</a></li>
  47       <li><a href="#ShowHideBlocking">Show/hide blocking</a></li>
  48       <li><a href="#ModalExclusion">Modal exclusion</a></li>
  49       <li><a href="#Related">Related AWT features</a></li>
  50       <li><a href="#Security">Security</a></li>
  51       <li><a href="#PlatformSupport">Platform support</a></li>
  52       <li><a href="#Compatibility">Compatibility</a></li>
  53       <li><a href="#Examples">Examples</a></li>
  54     </ul>
  55 
  56     <a id="Definitions"></a>
  57     <h2>Definitions</h2>


 423     </p>
 424 
 425     <h3 style="clear: left">Example 4</h3>
 426     <ol style="float: left">
 427         <li>Frame F is shown<br>
 428         <li>Toolkit-modal dialog D<sub>i</sub> is created, but not shown<br>
 429         <li>Document-modal dialog D<sub>ii</sub> is shown<br>
 430         <li>F becomes blocked by D<sub>ii</sub> &mdash; it's in the same document<br>
 431         <li>Application-modal dialog D<sub>iii</sub> is shown<br>
 432         <li>D<sub>ii</sub> becomes blocked by D<sub>iii</sub> &mdash; it's in the
 433             same application<br>
 434         <li>D<sub>i</sub> is shown<br>
 435         <li>D<sub>iii</sub> becomes blocked by D<sub>i</sub> &mdash; D<sub>i</sub>
 436             is not blocked<br>
 437         <li>D<sub>i</sub> remains unblocked<br>
 438     </ol>
 439     <p style="float: left; margin-left: 1em">
 440         <img src="modal-example4.gif" alt="Example 4">
 441     </p>
 442     <br style="clear:both;">

 443 </main>
 444 </body></html>


  18  particular file as subject to the "Classpath" exception as provided
  19  by Oracle in the LICENSE file that accompanied this code.
  20 
  21  This code is distributed in the hope that it will be useful, but WITHOUT
  22  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  23  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  24  version 2 for more details (a copy is included in the LICENSE file that
  25  accompanied this code).
  26 
  27  You should have received a copy of the GNU General Public License version
  28  2 along with this work; if not, write to the Free Software Foundation,
  29  Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  30 
  31  Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  32  or visit www.oracle.com if you need additional information or have any
  33  questions.
  34 -->
  35 
  36 <body>
  37 <main role="main">
  38 <div class="contentContainer">
  39     <h1>The AWT Modality</h1>
  40 
  41     <p>
  42       This document, together with the API documentation for modality-related
  43       classes (such as <code>java.awt.Dialog</code>), briefly describes the new
  44       modality features and how to use them. It contains the following sections:
  45     </p><ul>
  46       <li><a href="#Definitions">Definitions</a></li>
  47       <li><a href="#ModalityTypes">Modality types</a></li>
  48       <li><a href="#ShowHideBlocking">Show/hide blocking</a></li>
  49       <li><a href="#ModalExclusion">Modal exclusion</a></li>
  50       <li><a href="#Related">Related AWT features</a></li>
  51       <li><a href="#Security">Security</a></li>
  52       <li><a href="#PlatformSupport">Platform support</a></li>
  53       <li><a href="#Compatibility">Compatibility</a></li>
  54       <li><a href="#Examples">Examples</a></li>
  55     </ul>
  56 
  57     <a id="Definitions"></a>
  58     <h2>Definitions</h2>


 424     </p>
 425 
 426     <h3 style="clear: left">Example 4</h3>
 427     <ol style="float: left">
 428         <li>Frame F is shown<br>
 429         <li>Toolkit-modal dialog D<sub>i</sub> is created, but not shown<br>
 430         <li>Document-modal dialog D<sub>ii</sub> is shown<br>
 431         <li>F becomes blocked by D<sub>ii</sub> &mdash; it's in the same document<br>
 432         <li>Application-modal dialog D<sub>iii</sub> is shown<br>
 433         <li>D<sub>ii</sub> becomes blocked by D<sub>iii</sub> &mdash; it's in the
 434             same application<br>
 435         <li>D<sub>i</sub> is shown<br>
 436         <li>D<sub>iii</sub> becomes blocked by D<sub>i</sub> &mdash; D<sub>i</sub>
 437             is not blocked<br>
 438         <li>D<sub>i</sub> remains unblocked<br>
 439     </ol>
 440     <p style="float: left; margin-left: 1em">
 441         <img src="modal-example4.gif" alt="Example 4">
 442     </p>
 443     <br style="clear:both;">
 444 </div>
 445 </main>
 446 </body></html>
< prev index next >