/*

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

 *

 * This code is free software; you can redistribute it and/or modify it

 * under the terms of the GNU General Public License version 2 only, as

 * published by the Free Software Foundation.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the LICENSE file that accompanied this code.

 *

 * This code is distributed in the hope that it will be useful, but WITHOUT

 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License

 * version 2 for more details (a copy is included in the LICENSE file that

 * accompanied this code).

 *

 * You should have received a copy of the GNU General Public License version

 * 2 along with this work; if not, write to the Free Software Foundation,

 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

 *

 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA

 * or visit www.oracle.com if you need additional information or have any

 * questions.

 */

package javax.swing;

import java.awt.*;

import java.awt.event.*;

import javax.accessibility.*;

/**

 * The main class for creating a dialog window. You can use this class

 * to create a custom dialog, or invoke the many class methods

 * in {@link JOptionPane} to create a variety of standard dialogs.

 * For information about creating dialogs, see

 * <em>The Java Tutorial</em> section

 * <a

 href="http://java.sun.com/docs/books/tutorial/uiswing/components/dialog.html">How

 * to Make Dialogs</a>.

 *

 * <p>

 *

 * as its only child.

 * <pre>

 *       dialog.add(child);

 * </pre>

 * And the child will be added to the contentPane.

 * manager set on it.

 * Refer to {@link javax.swing.RootPaneContainer}

 * <p>

 * <p>

 * on a different screen device than its owner.  See {@link java.awt.Frame} for

 * more information.

 * <p>

 * <strong>Warning:</strong> Swing is not thread safe. For more

 * information see <a

 * href="package-summary.html#threading">Swing's Threading

 * Policy</a>.

 * <p>

 * <strong>Warning:</strong>

 * Serialized objects of this class will not be compatible with

 * future Swing releases. The current serialization support is

 * appropriate for short term storage or RMI between applications running

 * the same version of Swing.  As of 1.4, support for long term storage

 * of all JavaBeans<sup><font size="-2">TM</font></sup>

 * Please see {@link java.beans.XMLEncoder}.

 *

 * @see JOptionPane

 * @see JRootPane

 * @see javax.swing.RootPaneContainer

 *

 * @beaninfo

 *      attribute: isContainer true

 *      attribute: containerDelegate getContentPane

 *    description: A toplevel window for creating dialog boxes.

 *

 * @author David Kloba

 * @author James Gosling

 * @author Scott Violet

 */

public class JDialog extends Dialog implements WindowConstants,

                                               Accessible,

                                               RootPaneContainer,

                               TransferHandler.HasGetTransferHandler

{

    /**

     * Key into the AppContext, used to check if should provide decorations

     * by default.

     */

    private static final Object defaultLookAndFeelDecoratedKey =

            new StringBuffer("JDialog.defaultLookAndFeelDecorated");

    private int defaultCloseOperation = HIDE_ON_CLOSE;

    /**

     * @see #getRootPane

     * @see #setRootPane

     */

    protected JRootPane rootPane;

    /**

     *

     * @see #isRootPaneCheckingEnabled

     * @see #setRootPaneCheckingEnabled

     * @see javax.swing.RootPaneContainer

     */

    protected boolean rootPaneCheckingEnabled = false;

    /**

     */

    private TransferHandler transferHandler;

    /**

     * Creates a modeless dialog without a title and without a specified

     * set as the owner of the dialog.

     * <p>

     * This constructor sets the component's locale property to the value

     * <p>

     * NOTE: This constructor does not allow you to create an unowned

     *

     * @see java.awt.GraphicsEnvironment#isHeadless

     * @see JComponent#getDefaultLocale

     */

    public JDialog() {

        this((Frame)null, false);

    }

    /**

     * Creates a modeless dialog without a title with the

     * owner of the dialog.

     * <p>

     * This constructor sets the component's locale property to the value

     * <p>

     * NOTE: This constructor does not allow you to create an unowned

     *

     * @see java.awt.GraphicsEnvironment#isHeadless

     * @see JComponent#getDefaultLocale

     */

    public JDialog(Frame owner) {

        this(owner, false);

    }

    /**

     * a shared, hidden frame will be set as the owner of the dialog.

     * <p>

     * This constructor sets the component's locale property to the value

     * <p>

     * NOTE: This constructor does not allow you to create an unowned

     *

     * @param modal specifies whether dialog blocks user input to other top-level

     * @see java.awt.GraphicsEnvironment#isHeadless

     * @see JComponent#getDefaultLocale

     */

    public JDialog(Frame owner, boolean modal) {

        this(owner, null, modal);

    }

    /**

     * Creates a modeless dialog with the specified title and

     * owner of the dialog.

     * <p>

     * This constructor sets the component's locale property to the value

     * <p>

     * NOTE: This constructor does not allow you to create an unowned

     *

     *                  title bar

     * @see java.awt.GraphicsEnvironment#isHeadless

     * @see JComponent#getDefaultLocale

     */

    public JDialog(Frame owner, String title) {

        this(owner, title, false);

    }

    /**

     * a shared, hidden frame will be set as the owner of this dialog.

     * <p>

     * This constructor sets the component's locale property to the value

     * <p>

     * created within a modal dialog will be forced to be lightweight.

     * <p>

     * NOTE: This constructor does not allow you to create an unowned

     *

     *     title bar

     * @param modal specifies whether dialog blocks user input to other top-level

     *

     * @see java.awt.Dialog.ModalityType

     * @see java.awt.Dialog.ModalityType#MODELESS

     * @see java.awt.Dialog#DEFAULT_MODALITY_TYPE

     * @see java.awt.Dialog#setModal

     * @see java.awt.Dialog#setModalityType

     * @see java.awt.GraphicsEnvironment#isHeadless

     * @see JComponent#getDefaultLocale

     */

    public JDialog(Frame owner, String title, boolean modal) {

        super(owner == null? SwingUtilities.getSharedOwnerFrame() : owner,

              title, modal);

        if (owner == null) {

            WindowListener ownerShutdownListener =

                    SwingUtilities.getSharedOwnerFrameShutdownListener();

            addWindowListener(ownerShutdownListener);

        }

        dialogInit();

    }

    /**

     * Creates a dialog with the specified title,

     * a shared, hidden frame will be set as the owner of this dialog.

     * <p>

     * This constructor sets the component's locale property to the value

     * <p>

     * created within a modal dialog will be forced to be lightweight.

     * <p>

     * NOTE: This constructor does not allow you to create an unowned

     *

     *     title bar

     * @param modal specifies whether dialog blocks user input to other top-level

     * @see java.awt.Dialog.ModalityType

     * @see java.awt.Dialog.ModalityType#MODELESS

     * @see java.awt.Dialog#DEFAULT_MODALITY_TYPE

     * @see java.awt.Dialog#setModal

     * @see java.awt.Dialog#setModalityType

     * @see java.awt.GraphicsEnvironment#isHeadless

     * @see JComponent#getDefaultLocale

     * @since 1.4

     */

    public JDialog(Frame owner, String title, boolean modal,

                   GraphicsConfiguration gc) {

        super(owner == null? SwingUtilities.getSharedOwnerFrame() : owner,

              title, modal, gc);

        if (owner == null) {

            WindowListener ownerShutdownListener =

                    SwingUtilities.getSharedOwnerFrameShutdownListener();

            addWindowListener(ownerShutdownListener);

        }

        dialogInit();

    }

    /**

     * Creates a modeless dialog without a title with the

     * <p>

     * This constructor sets the component's locale property to the value

     *

     * @see java.awt.GraphicsEnvironment#isHeadless

     * @see JComponent#getDefaultLocale

     */

    public JDialog(Dialog owner) {

        this(owner, false);

    }

    /**

     * <p>

     * This constructor sets the component's locale property to the value

     *

     * @param modal specifies whether dialog blocks user input to other top-level

     * @see java.awt.Dialog.ModalityType

     * @see java.awt.Dialog.ModalityType#MODELESS

     * @see java.awt.Dialog#DEFAULT_MODALITY_TYPE

     * @see java.awt.Dialog#setModal

     * @see java.awt.Dialog#setModalityType

     * @see java.awt.GraphicsEnvironment#isHeadless

     * @see JComponent#getDefaultLocale

     */

    public JDialog(Dialog owner, boolean modal) {

        this(owner, null, modal);

    }

    /**

     * Creates a modeless dialog with the specified title and

     * with the specified owner dialog.

     * <p>

     * This constructor sets the component's locale property to the value

     *

     *                  title bar

     * @see java.awt.GraphicsEnvironment#isHeadless

     * @see JComponent#getDefaultLocale

     */

    public JDialog(Dialog owner, String title) {

        this(owner, title, false);

    }

    /**

     * Creates a dialog with the specified title, modality

     * <p>

     * This constructor sets the component's locale property to the value

     *

     *     title bar

     * @param modal specifies whether dialog blocks user input to other top-level

     * @see java.awt.Dialog.ModalityType

     * @see java.awt.Dialog.ModalityType#MODELESS

     * @see java.awt.Dialog#DEFAULT_MODALITY_TYPE

     * @see java.awt.Dialog#setModal

     * @see java.awt.Dialog#setModalityType

     * @see java.awt.GraphicsEnvironment#isHeadless

     * @see JComponent#getDefaultLocale

     */

    public JDialog(Dialog owner, String title, boolean modal) {

        super(owner, title, modal);

        dialogInit();

    }

    /**

     *

     * <p>

     * created within a modal dialog will be forced to be lightweight.

     * <p>

     * This constructor sets the component's locale property to the value

     *

     *     title bar

     * @param modal specifies whether dialog blocks user input to other top-level

     * @see java.awt.Dialog.ModalityType

     * @see java.awt.Dialog.ModalityType#MODELESS

     * @see java.awt.Dialog#DEFAULT_MODALITY_TYPE

     * @see java.awt.Dialog#setModal

     * @see java.awt.Dialog#setModalityType

     * @see java.awt.GraphicsEnvironment#isHeadless

     * @see JComponent#getDefaultLocale

     * @since 1.4

     */

    public JDialog(Dialog owner, String title, boolean modal,

                   GraphicsConfiguration gc) {

        super(owner, title, modal, gc);

        dialogInit();

    }

    /**

     * an empty title.

     * <p>

     * This constructor sets the component's locale property to the value

     *

     *

     * @see java.awt.GraphicsEnvironment#isHeadless

     * @see JComponent#getDefaultLocale

     *

     * @since 1.6

     */

    public JDialog(Window owner) {

        this(owner, Dialog.ModalityType.MODELESS);

    }

    /**

     * and an empty title.

     * <p>

     * This constructor sets the component's locale property to the value

     *

     * @param modalityType specifies whether dialog blocks input to other