jdk/src/java.desktop/share/classes/java/awt/Dialog.java
changeset 26749 b6598aa90114
parent 25859 3317bb8137f4
child 28231 b608ffcaed74
equal deleted inserted replaced
26748:fba66a2e8961 26749:b6598aa90114
   258          * it isn't blocked by document-modal dialogs from outside of its
   258          * it isn't blocked by document-modal dialogs from outside of its
   259          * child hierarchy.
   259          * child hierarchy.
   260          * The "toolkitModality" <code>AWTPermission</code> must be granted
   260          * The "toolkitModality" <code>AWTPermission</code> must be granted
   261          * for this exclusion. If an exclusion property is being changed to
   261          * for this exclusion. If an exclusion property is being changed to
   262          * <code>TOOLKIT_EXCLUDE</code> and this permission is not granted, a
   262          * <code>TOOLKIT_EXCLUDE</code> and this permission is not granted, a
   263          * <code>SecurityEcxeption</code> will be thrown, and the exclusion
   263          * <code>SecurityException</code> will be thrown, and the exclusion
   264          * property will be left unchanged.
   264          * property will be left unchanged.
   265          */
   265          */
   266         TOOLKIT_EXCLUDE
   266         TOOLKIT_EXCLUDE
   267     };
   267     };
   268 
   268 
   552      * Constructs an initially invisible, modeless <code>Dialog</code> with the
   552      * Constructs an initially invisible, modeless <code>Dialog</code> with the
   553      * specified owner <code>Window</code> and an empty title.
   553      * specified owner <code>Window</code> and an empty title.
   554      *
   554      *
   555      * @param owner the owner of the dialog. The owner must be an instance of
   555      * @param owner the owner of the dialog. The owner must be an instance of
   556      *     {@link java.awt.Dialog Dialog}, {@link java.awt.Frame Frame}, any
   556      *     {@link java.awt.Dialog Dialog}, {@link java.awt.Frame Frame}, any
   557      *     of their descendents or <code>null</code>
   557      *     of their descendants or <code>null</code>
   558      *
   558      *
   559      * @exception java.lang.IllegalArgumentException if the <code>owner</code>
   559      * @exception java.lang.IllegalArgumentException if the <code>owner</code>
   560      *     is not an instance of {@link java.awt.Dialog Dialog} or {@link
   560      *     is not an instance of {@link java.awt.Dialog Dialog} or {@link
   561      *     java.awt.Frame Frame}
   561      *     java.awt.Frame Frame}
   562      * @exception java.lang.IllegalArgumentException if the <code>owner</code>'s
   562      * @exception java.lang.IllegalArgumentException if the <code>owner</code>'s
   576      * Constructs an initially invisible, modeless <code>Dialog</code> with
   576      * Constructs an initially invisible, modeless <code>Dialog</code> with
   577      * the specified owner <code>Window</code> and title.
   577      * the specified owner <code>Window</code> and title.
   578      *
   578      *
   579      * @param owner the owner of the dialog. The owner must be an instance of
   579      * @param owner the owner of the dialog. The owner must be an instance of
   580      *    {@link java.awt.Dialog Dialog}, {@link java.awt.Frame Frame}, any
   580      *    {@link java.awt.Dialog Dialog}, {@link java.awt.Frame Frame}, any
   581      *    of their descendents or <code>null</code>
   581      *    of their descendants or <code>null</code>
   582      * @param title the title of the dialog or <code>null</code> if this dialog
   582      * @param title the title of the dialog or <code>null</code> if this dialog
   583      *    has no title
   583      *    has no title
   584      *
   584      *
   585      * @exception java.lang.IllegalArgumentException if the <code>owner</code>
   585      * @exception java.lang.IllegalArgumentException if the <code>owner</code>
   586      *    is not an instance of {@link java.awt.Dialog Dialog} or {@link
   586      *    is not an instance of {@link java.awt.Dialog Dialog} or {@link
   602      * Constructs an initially invisible <code>Dialog</code> with the
   602      * Constructs an initially invisible <code>Dialog</code> with the
   603      * specified owner <code>Window</code> and modality and an empty title.
   603      * specified owner <code>Window</code> and modality and an empty title.
   604      *
   604      *
   605      * @param owner the owner of the dialog. The owner must be an instance of
   605      * @param owner the owner of the dialog. The owner must be an instance of
   606      *    {@link java.awt.Dialog Dialog}, {@link java.awt.Frame Frame}, any
   606      *    {@link java.awt.Dialog Dialog}, {@link java.awt.Frame Frame}, any
   607      *    of their descendents or <code>null</code>
   607      *    of their descendants or <code>null</code>
   608      * @param modalityType specifies whether dialog blocks input to other
   608      * @param modalityType specifies whether dialog blocks input to other
   609      *    windows when shown. <code>null</code> value and unsupported modality
   609      *    windows when shown. <code>null</code> value and unsupported modality
   610      *    types are equivalent to <code>MODELESS</code>
   610      *    types are equivalent to <code>MODELESS</code>
   611      *
   611      *
   612      * @exception java.lang.IllegalArgumentException if the <code>owner</code>
   612      * @exception java.lang.IllegalArgumentException if the <code>owner</code>
   635      * Constructs an initially invisible <code>Dialog</code> with the
   635      * Constructs an initially invisible <code>Dialog</code> with the
   636      * specified owner <code>Window</code>, title and modality.
   636      * specified owner <code>Window</code>, title and modality.
   637      *
   637      *
   638      * @param owner the owner of the dialog. The owner must be an instance of
   638      * @param owner the owner of the dialog. The owner must be an instance of
   639      *     {@link java.awt.Dialog Dialog}, {@link java.awt.Frame Frame}, any
   639      *     {@link java.awt.Dialog Dialog}, {@link java.awt.Frame Frame}, any
   640      *     of their descendents or <code>null</code>
   640      *     of their descendants or <code>null</code>
   641      * @param title the title of the dialog or <code>null</code> if this dialog
   641      * @param title the title of the dialog or <code>null</code> if this dialog
   642      *     has no title
   642      *     has no title
   643      * @param modalityType specifies whether dialog blocks input to other
   643      * @param modalityType specifies whether dialog blocks input to other
   644      *    windows when shown. <code>null</code> value and unsupported modality
   644      *    windows when shown. <code>null</code> value and unsupported modality
   645      *    types are equivalent to <code>MODELESS</code>
   645      *    types are equivalent to <code>MODELESS</code>
   683      * specified owner <code>Window</code>, title, modality and
   683      * specified owner <code>Window</code>, title, modality and
   684      * <code>GraphicsConfiguration</code>.
   684      * <code>GraphicsConfiguration</code>.
   685      *
   685      *
   686      * @param owner the owner of the dialog. The owner must be an instance of
   686      * @param owner the owner of the dialog. The owner must be an instance of
   687      *     {@link java.awt.Dialog Dialog}, {@link java.awt.Frame Frame}, any
   687      *     {@link java.awt.Dialog Dialog}, {@link java.awt.Frame Frame}, any
   688      *     of their descendents or <code>null</code>
   688      *     of their descendants or <code>null</code>
   689      * @param title the title of the dialog or <code>null</code> if this dialog
   689      * @param title the title of the dialog or <code>null</code> if this dialog
   690      *     has no title
   690      *     has no title
   691      * @param modalityType specifies whether dialog blocks input to other
   691      * @param modalityType specifies whether dialog blocks input to other
   692      *    windows when shown. <code>null</code> value and unsupported modality
   692      *    windows when shown. <code>null</code> value and unsupported modality
   693      *    types are equivalent to <code>MODELESS</code>
   693      *    types are equivalent to <code>MODELESS</code>
   794      * until it is hidden and then shown again.
   794      * until it is hidden and then shown again.
   795      *
   795      *
   796      * @param modal specifies whether dialog blocks input to other windows
   796      * @param modal specifies whether dialog blocks input to other windows
   797      *     when shown; calling to <code>setModal(true)</code> is equivalent to
   797      *     when shown; calling to <code>setModal(true)</code> is equivalent to
   798      *     <code>setModalityType(Dialog.DEFAULT_MODALITY_TYPE)</code>, and
   798      *     <code>setModalityType(Dialog.DEFAULT_MODALITY_TYPE)</code>, and
   799      *     calling to <code>setModal(false)</code> is equvivalent to
   799      *     calling to <code>setModal(false)</code> is equivalent to
   800      *     <code>setModalityType(Dialog.ModalityType.MODELESS)</code>
   800      *     <code>setModalityType(Dialog.ModalityType.MODELESS)</code>
   801      *
   801      *
   802      * @see       java.awt.Dialog#DEFAULT_MODALITY_TYPE
   802      * @see       java.awt.Dialog#DEFAULT_MODALITY_TYPE
   803      * @see       java.awt.Dialog.ModalityType#MODELESS
   803      * @see       java.awt.Dialog.ModalityType#MODELESS
   804      * @see       java.awt.Dialog#isModal
   804      * @see       java.awt.Dialog#isModal
   924                 }
   924                 }
   925 
   925 
   926                 if (toFocus != null && time != null && isFocusable() &&
   926                 if (toFocus != null && time != null && isFocusable() &&
   927                     isEnabled() && !isModalBlocked()) {
   927                     isEnabled() && !isModalBlocked()) {
   928                     // keep the KeyEvents from being dispatched
   928                     // keep the KeyEvents from being dispatched
   929                     // until the focus has been transfered
   929                     // until the focus has been transferred
   930                     time.set(Toolkit.getEventQueue().getMostRecentKeyEventTime());
   930                     time.set(Toolkit.getEventQueue().getMostRecentKeyEventTime());
   931                     KeyboardFocusManager.getCurrentKeyboardFocusManager().
   931                     KeyboardFocusManager.getCurrentKeyboardFocusManager().
   932                         enqueueKeyEvents(time.get(), toFocus);
   932                         enqueueKeyEvents(time.get(), toFocus);
   933                 }
   933                 }
   934 
   934