200 If there are several such dialogs, the first shown is used. |
204 If there are several such dialogs, the first shown is used. |
201 If no such dialogs exist, M remains unblocked. |
205 If no such dialogs exist, M remains unblocked. |
202 </p><p> |
206 </p><p> |
203 <u>Showing the toolkit-modal dialog: "M"</u><br> |
207 <u>Showing the toolkit-modal dialog: "M"</u><br> |
204 M remains unblocked. |
208 M remains unblocked. |
205 </p><p> |
209 |
206 <!-- <center> --> |
|
207 </p> |
|
208 <table border="1"> |
210 <table border="1"> |
209 <caption>The Standard Blocking Matrix</caption> |
211 <caption>The Standard Blocking Matrix</caption> |
210 <tbody><tr align="center"> |
212 <tbody><tr> |
211 <td align="center">current/shown</td> |
213 <td>current/shown</td> |
212 <td align="center">frame & modeless</td> |
214 <td>frame & modeless</td> |
213 <td align="center">document</td> |
215 <td>document</td> |
214 <td align="center">application</td> |
216 <td>application</td> |
215 <td align="center">toolkit</td> |
217 <td>toolkit</td> |
216 </tr> |
218 </tr> |
217 <tr align="center"> |
219 <tr> |
218 <td align="center">-</td> |
220 <td>-</td> |
219 <td align="center">-</td> |
221 <td>-</td> |
220 <td align="center">-</td> |
222 <td>-</td> |
221 <td align="center">-</td> |
223 <td>-</td> |
222 <td align="center">-</td> |
224 <td>-</td> |
223 </tr> |
225 </tr> |
224 <tr align="center"> |
226 <tr> |
225 <td align="center">document</td> |
227 <td>document</td> |
226 <td align="center">blocked</td> |
228 <td>blocked</td> |
227 <td align="center">-</td> |
229 <td>-</td> |
228 <td align="center">-</td> |
230 <td>-</td> |
229 <td align="center">-</td> |
231 <td>-</td> |
230 </tr> |
232 </tr> |
231 <tr align="center"> |
233 <tr> |
232 <td align="center">application</td> |
234 <td>application</td> |
233 <td align="center">blocked</td> |
235 <td>blocked</td> |
234 <td align="center">blocked</td> |
236 <td>blocked</td> |
235 <td align="center">-</td> |
237 <td>-</td> |
236 <td align="center">-</td> |
238 <td>-</td> |
237 </tr> |
239 </tr> |
238 <tr align="center"> |
240 <tr> |
239 <td align="center">toolkit</td> |
241 <td>toolkit</td> |
240 <td align="center">blocked</td> |
242 <td>blocked</td> |
241 <td align="center">blocked</td> |
243 <td>blocked</td> |
242 <td align="center">blocked</td> |
244 <td>blocked</td> |
243 <td align="center">-</td> |
245 <td>-</td> |
244 </tr> |
246 </tr> |
245 </tbody></table> |
247 </tbody> |
246 <!-- </center> --> |
248 </table> |
247 <p> |
249 <p> |
248 After the modal dialog is shown, all the windows from its SB are blocked, |
250 After the modal dialog is shown, all the windows from its SB are blocked, |
249 except those that block this modal dialog. |
251 except those that block this modal dialog. |
250 </p><p> |
252 </p><p> |
251 <u>Hiding the window or modeless dialog: "F"</u><br> |
253 <u>Hiding the window or modeless dialog: "F"</u><br> |
376 <a id="Examples"></a> |
378 <a id="Examples"></a> |
377 </p><h2>Examples</h2> |
379 </p><h2>Examples</h2> |
378 |
380 |
379 <table border="0"> |
381 <table border="0"> |
380 <tbody><tr> |
382 <tbody><tr> |
381 <td align="left" > |
383 <td style="text-align:left" > |
382 <ol> |
384 <ol> |
383 <li>Frame "F" is shown<br> |
385 <li>Frame "F" is shown<br> |
384 <li>Document-modal dialog "D<sub>i</sub>" is shown<br> |
386 <li>Document-modal dialog "D<sub>i</sub>" is shown<br> |
385 <li>F becomes blocked by D<sub>i</sub> — it's in the same document<br> |
387 <li>F becomes blocked by D<sub>i</sub> — it's in the same document<br> |
386 <li>Document-modal dialog "D<sub>ii</sub>" is shown<br> |
388 <li>Document-modal dialog "D<sub>ii</sub>" is shown<br> |
387 <li>D<sub>i</sub> becomes blocked by D<sub>ii</sub> — it's in the |
389 <li>D<sub>i</sub> becomes blocked by D<sub>ii</sub> — it's in the |
388 same document<br> |
390 same document<br> |
389 </ol> |
391 </ol> |
390 <br> |
392 <br> |
391 </td> |
393 </td> |
392 <td align="center"> |
394 <td> |
393 <img src="modal-example1.gif" alt="Example 1"> |
395 <img src="modal-example1.gif" alt="Example 1"> |
394 <br> |
396 <br> |
395 </td> |
397 </td> |
396 </tr> |
398 </tr> |
397 <tr> |
399 <tr> |
398 <td align="left"> |
400 <td style="text-align:left"> |
399 <ol> |
401 <ol> |
400 <li>Frame "F" is shown<br> |
402 <li>Frame "F" is shown<br> |
401 <li>Document-modal dialog "D<sub>i</sub>" is shown<br> |
403 <li>Document-modal dialog "D<sub>i</sub>" is shown<br> |
402 <li>F becomes blocked by D<sub>i</sub> — it's in the same document<br> |
404 <li>F becomes blocked by D<sub>i</sub> — it's in the same document<br> |
403 <li>Document-modal dialog "D<sub>ii</sub>" is shown<br> |
405 <li>Document-modal dialog "D<sub>ii</sub>" is shown<br> |
404 <li>D<sub>i</sub> becomes blocked by D<sub>ii</sub> — |
406 <li>D<sub>i</sub> becomes blocked by D<sub>ii</sub> — |
405 it's in the same document<br> |
407 it's in the same document<br> |
406 <li>D<sub>i</sub> is hidden<br> |
408 <li>D<sub>i</sub> is hidden<br> |
407 <li>F becomes blocked by D<sub>ii</sub> — it's in the same document<br> |
409 <li>F becomes blocked by D<sub>ii</sub> — it's in the same document<br> |
408 </ol> |
410 </ol> |
409 <br> |
411 <br> |
410 </td> |
412 </td> |
411 <td align="center"> |
413 <td> |
412 <img src="modal-example2.gif" alt="Example 2"> |
414 <img src="modal-example2.gif" alt="Example 2"> |
413 <br> |
415 <br> |
414 </td> |
416 </td> |
415 </tr> |
417 </tr> |
416 <tr> |
418 <tr> |
417 <td align="left"> |
419 <td style="text-align:left"> |
418 <ol> |
420 <ol> |
419 <li>Frame "F" is shown<br> |
421 <li>Frame "F" is shown<br> |
420 <li>Toolkit-modal dialog "D<sub>i</sub>" is created, but not shown<br> |
422 <li>Toolkit-modal dialog "D<sub>i</sub>" is created, but not shown<br> |
421 <li>Document-modal dialog "D<sub>ii</sub>" is shown<br> |
423 <li>Document-modal dialog "D<sub>ii</sub>" is shown<br> |
422 <li>F becomes blocked by D<sub>ii</sub> — it's in the same document<br> |
424 <li>F becomes blocked by D<sub>ii</sub> — it's in the same document<br> |
423 <li>Application-modal dialog "D<sub>iii</sub>" is shown<br> |
425 <li>Application-modal dialog "D<sub>iii</sub>" is shown<br> |
424 <li>D<sub>ii</sub> becomes blocked by D<sub>iii</sub> — |
426 <li>D<sub>ii</sub> becomes blocked by D<sub>iii</sub> — |
425 it's in the same application<br> |
427 it's in the same application<br> |
426 <li>D<sub>i</sub> is shown<br> |
428 <li>D<sub>i</sub> is shown<br> |
427 <li>D<sub>i</sub> becomes blocked by D<sub>ii</sub> — it's its owner<br> |
429 <li>D<sub>i</sub> becomes blocked by D<sub>ii</sub> — it's its owner<br> |
428 <li>D<sub>iii</sub> remains unblocked — it blocks D<sub>ii</sub> and |
430 <li>D<sub>iii</sub> remains unblocked — it blocks D<sub>ii</sub> and |
429 D<sub>ii</sub> blocks D<sub>i</sub><br> |
431 D<sub>ii</sub> blocks D<sub>i</sub><br> |
430 </ol> |
432 </ol> |
431 <br> |
433 <br> |
432 </td> |
434 </td> |
433 <td align="center"> |
435 <td> |
434 <img src="modal-example3.gif" alt="Example 3"> |
436 <img src="modal-example3.gif" alt="Example 3"> |
435 <br> |
437 <br> |
436 </td> |
438 </td> |
437 </tr> |
439 </tr> |
438 <tr> |
440 <tr> |
439 <td align="left"> |
441 <td style="text-align:left"> |
440 <ol> |
442 <ol> |
441 <li>Frame "F" is shown<br> |
443 <li>Frame "F" is shown<br> |
442 <li>Toolkit-modal dialog "D<sub>i</sub>" is created, but not shown<br> |
444 <li>Toolkit-modal dialog "D<sub>i</sub>" is created, but not shown<br> |
443 <li>Document-modal dialog "D<sub>ii</sub>" is shown<br> |
445 <li>Document-modal dialog "D<sub>ii</sub>" is shown<br> |
444 <li>F becomes blocked by D<sub>ii</sub> — it's in the same document<br> |
446 <li>F becomes blocked by D<sub>ii</sub> — it's in the same document<br> |
445 <li>Application-modal dialog "D<sub>iii</sub>" is shown<br> |
447 <li>Application-modal dialog "D<sub>iii</sub>" is shown<br> |
446 <li>D<sub>ii</sub> becomes blocked by D<sub>iii</sub> — it's in the |
448 <li>D<sub>ii</sub> becomes blocked by D<sub>iii</sub> — it's in the |
447 same application<br> |
449 same application<br> |
448 <li>D<sub>i</sub> is shown<br> |
450 <li>D<sub>i</sub> is shown<br> |
449 <li>D<sub>iii</sub> becomes blocked by D<sub>i</sub> — D<sub>i</sub> |
451 <li>D<sub>iii</sub> becomes blocked by D<sub>i</sub> — D<sub>i</sub> |
450 is not blocked<br> |
452 is not blocked<br> |
451 <li>D<sub>i</sub> remains unblocked<br> |
453 <li>D<sub>i</sub> remains unblocked<br> |
452 </ol> |
454 </ol> |
453 <br> |
455 <br> |
454 </td> |
456 </td> |
455 <td align="center"> |
457 <td> |
456 <img src="modal-example4.gif" alt="Example 4"> |
458 <img src="modal-example4.gif" alt="Example 4"> |
457 <br> |
459 <br> |
458 </td> |
460 </td> |
459 </tr> |
461 </tr> |
460 </tbody></table> |
462 </tbody></table> |