JDialog (Java Platform SE 8 )

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - java.awt.Window
    - - java.awt.Dialog
      - javax.swing.JDialog

All Implemented Interfaces:

ImageObserver ， MenuContainer ， Serializable ， Accessible ， RootPaneContainer ， WindowConstants
```
public class JDialog
extends Dialog
implements WindowConstants, Accessible, RootPaneContainer
```
创建对话窗口的主要类。您可以使用此类创建自定义对话框，或者在JOptionPane中调用许多类方法来创建各种标准对话框。有关创建对话框的信息，请参阅Java Tutorial How to Make Dialogs 。
JDialog组件包含一个JRootPane作为其唯一的孩子。 contentPane应该是contentPane的任何孩子的JDialog 。作为一种方便， add ， remove和setLayout这个类的方法将被覆盖，所以他们委托给相应方法的调用ContentPane 。例如，您可以将子组件添加到对话框中，如下所示：
```
  dialog.add(child); 
```
而孩子将被添加到contentPane。 contentPane始终null 。尝试将其设置为null会生成异常。默认的contentPane有一个BorderLayout管理器就可以了。有关添加，删除和设置LayoutManager的LayoutManager的详细信息，请参阅JDialog 。
请参阅JRootPane文档的完整描述contentPane ， glassPane和layeredPane组件。

在多屏幕环境中，您可以在与其所有者不同的屏幕设备上创建JDialog 。见Frame以获取更多信息。

警告： Swing不是线程安全的。有关详细信息，请参阅Swing's Threading Policy 。

警告：此类的序列化对象与将来的Swing版本不兼容。当前的序列化支持适用于运行相同版本的Swing的应用程序之间的短期存储或RMI。从1.4开始，支持所有JavaBeans的长期存储已被添加到java.beans包中。请参阅XMLEncoder 。
另请参见：

JOptionPane ， JRootPane ， RootPaneContainer

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected class`	`JDialog.AccessibleJDialog` 这个类实现了可访问性支持 `JDialog`类。

Nested classes/interfaces inherited from class java.awt.Dialog
Dialog.AccessibleAWTDialog, Dialog.ModalExclusionType, Dialog.ModalityType

Nested classes/interfaces inherited from class java.awt.Window
Window.AccessibleAWTWindow, Window.Type

Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields
Modifier and Type	Field and Description
`protected AccessibleContext`	`accessibleContext`
`protected JRootPane`	`rootPane`
`protected boolean`	`rootPaneCheckingEnabled` 如果为真，那么 `add`和 `setLayout`将被转发到 `contentPane` 。

Fields inherited from class java.awt.Dialog
DEFAULT_MODALITY_TYPE

Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface javax.swing.WindowConstants
DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE

Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

构造方法摘要

构造方法
Constructor and Description
`JDialog()` 创建一个没有标题的无模式对话框，没有指定的 `Frame`所有者。
`JDialog(Dialog owner)` 使用指定的 `Dialog`作为其所有者创建无模式对话框，并创建一个空的标题。
`JDialog(Dialog owner, boolean modal)` 创建一个具有空标题和指定模态的对话框，并以其所有者为 `Dialog` 。
`JDialog(Dialog owner, String title)` 使用指定的标题和指定的所有者对话框创建无模式对话框。
`JDialog(Dialog owner, String title, boolean modal)` 创建一个具有指定标题，模态和指定所有者的 `Dialog` 。
`JDialog(Dialog owner, String title, boolean modal, GraphicsConfiguration gc)` 创建一个具有指定标题的对话框，所有者为 `Dialog` ，模式和 `GraphicsConfiguration` 。
`JDialog(Frame owner)` 创建一个无模式对话框，其中指定的是 `Frame`作为其所有者，并且是一个空的标题。
`JDialog(Frame owner, boolean modal)` 创建一个具有空标题和指定模态的对话框，并以 `Frame`作为其所有者。
`JDialog(Frame owner, String title)` 使用指定的标题和指定的所有者框架创建无模式对话框。
`JDialog(Frame owner, String title, boolean modal)` 创建一个具有指定标题的对话框，所有者为 `Frame`和模态。
`JDialog(Frame owner, String title, boolean modal, GraphicsConfiguration gc)` 创建一个具有指定标题的对话框，所有者为 `Frame` ，模态和 `GraphicsConfiguration` 。
`JDialog(Window owner)` 创建一个无模式的对话框，其中指定的是 `Window`作为其所有者，并且是一个空的标题。
`JDialog(Window owner, Dialog.ModalityType modalityType)` 创建一个具有空标题和指定模式的对话框，并以其所有者身份创建 `Window` 。
`JDialog(Window owner, String title)` 使用指定的标题和所有者创建一个无模式对话框 `Window` 。
`JDialog(Window owner, String title, Dialog.ModalityType modalityType)` 创建一个具有指定标题的对话框，所有者为 `Window`和模态。
`JDialog(Window owner, String title, Dialog.ModalityType modalityType, GraphicsConfiguration gc)` 创建一个具有指定标题的对话框，所有者为 `Window` ，模态和 `GraphicsConfiguration` 。

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`protected void`	`addImpl(Component comp, Object constraints, int index)` 添加指定的小孩 `Component` 。
`protected JRootPane`	`createRootPane()` 由构造函数调用方法创建默认值 `rootPane` 。
`protected void`	`dialogInit()` 由构造函数调用正确地初始化 `JDialog` 。
`AccessibleContext`	`getAccessibleContext()` 获取与此JDialog关联的AccessibleContext。
`Container`	`getContentPane()` 返回此对话框的 `contentPane`对象。
`int`	`getDefaultCloseOperation()` 返回用户在此对话框上启动“关闭”时发生的操作。
`Component`	`getGlassPane()` 返回此对话框的 `glassPane`对象。
`Graphics`	`getGraphics()` 为此组件创建图形上下文。
`JMenuBar`	`getJMenuBar()` 返回此对话框上的菜单栏。
`JLayeredPane`	`getLayeredPane()` 返回此对话框的 `layeredPane`对象。
`JRootPane`	`getRootPane()` 返回此对话框的 `rootPane`对象。
`TransferHandler`	`getTransferHandler()` 获取 `transferHandler`财产。
`static boolean`	`isDefaultLookAndFeelDecorated()` 如果新创建的 `JDialog`应该具有当前外观提供的窗口装饰，则返回true。
`protected boolean`	`isRootPaneCheckingEnabled()` 返回是否向 `add`和 `setLayout`的 `contentPane` 。
`protected String`	`paramString()` 返回此 `JDialog`的字符串表示 `JDialog` 。
`protected void`	`processWindowEvent(WindowEvent e)` 根据 `defaultCloseOperation`属性的状态处理窗口事件。
`void`	`remove(Component comp)` 从容器中删除指定的组件。
`void`	`repaint(long time, int x, int y, int width, int height)` 在time毫秒内 `time`绘制该组件的 `time`矩形。
`void`	`setContentPane(Container contentPane)` 设置 `contentPane`属性。
`void`	`setDefaultCloseOperation(int operation)` 设置用户在此对话框上启动“关闭”时默认执行的操作。
`static void`	`setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated)` 提供一个提示，即新创建的 `JDialog`是否应该具有当前的外观和感觉提供的窗口装饰（如边框，关闭窗口，标题...）。
`void`	`setGlassPane(Component glassPane)` 设置 `glassPane`属性。
`void`	`setJMenuBar(JMenuBar menu)` 设置此对话框的菜单栏。
`void`	`setLayeredPane(JLayeredPane layeredPane)` 设置 `layeredPane`属性。
`void`	`setLayout(LayoutManager manager)` 设置 `LayoutManager` 。
`protected void`	`setRootPane(JRootPane root)` 设置 `rootPane`属性。
`protected void`	`setRootPaneCheckingEnabled(boolean enabled)` 设置是否向 `add`和 `setLayout`的 `contentPane` 。
`void`	`setTransferHandler(TransferHandler newHandler)` 设置 `transferHandler`属性，这是一种支持将数据传输到此组件的机制。
`void`	`update(Graphics g)` 致电 `paint(g)` 。

Methods inherited from class java.awt.Dialog
addNotify, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setBackground, setModal, setModalityType, setOpacity, setResizable, setShape, setTitle, setUndecorated, setVisible, show, toBack

Methods inherited from class java.awt.Window
addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, toFront

Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 字段详细信息
  - rootPane
```
protected JRootPane rootPane
```
    另请参见：
    
    getRootPane() ， setRootPane(javax.swing.JRootPane)
  - rootPaneCheckingEnabled
```
protected boolean rootPaneCheckingEnabled
```
    如果为真，那么add和setLayout将被转发到contentPane 。这最初是假的，但是当JDialog时设置为true。
    
    另请参见：
    
    isRootPaneCheckingEnabled() ， setRootPaneCheckingEnabled(boolean) ， RootPaneContainer
  - accessibleContext
```
protected AccessibleContext accessibleContext
```
- 构造方法详细信息
  - JDialog
```
public JDialog()
```
    创建一个没有标题的无模式对话框，没有指定的Frame所有者。共享的隐藏框架将被设置为对话框的所有者。
    这个构造函数将组件的区域属性返回的值JComponent.getDefaultLocale 。
    
    注意：此构造函数不允许您创建JDialog 。要创建一个无主JDialog ，你必须使用JDialog(Window)或JDialog(Dialog)构造函数的参数null 。
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless()返回 true 。
    
    另请参见：
    
    GraphicsEnvironment.isHeadless() ， JComponent.getDefaultLocale()
  - JDialog
```
public JDialog(Frame owner)
```
    创建一个无模式对话框，其中指定的是Frame作为其所有者，并且是一个空的标题。如果owner为null ，则共享的隐藏帧将被设置为对话框的所有者。
    这个构造函数将组件的区域属性返回的值JComponent.getDefaultLocale 。
    
    注意：此构造函数不允许您创建JDialog 。要创建JDialog您必须使用参数null的JDialog(Window)或JDialog(Dialog)构造函数。
    
    参数
    
    owner -在 Frame从中显示的对话框
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless()返回 true 。
    
    另请参见：
    
    GraphicsEnvironment.isHeadless() ， JComponent.getDefaultLocale()
  - JDialog
```
public JDialog(Frame owner,
               boolean modal)
```
    创建一个具有空标题和指定模式的对话框，并以Frame作为其所有者。如果owner为null ， null共享的隐藏帧设置为对话框的所有者。
    这个构造函数将组件的区域属性返回的值JComponent.getDefaultLocale 。
    
    注意：此构造函数不允许您创建JDialog 。要创建JDialog您必须使用参数null的JDialog(Window)或JDialog(Dialog)构造函数。
    
    参数
    
    owner -在 Frame从中显示的对话框
    
    modal - 指定对话框是否显示用户输入到其他顶级窗口。如果true ，模态类型属性设置为DEFAULT_MODALITY_TYPE ，否则对话框是无模式的。
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless()返回 true 。
    
    另请参见：
    
    GraphicsEnvironment.isHeadless() ， JComponent.getDefaultLocale()
  - JDialog
```
public JDialog(Frame owner,
               String title)
```
    使用指定的标题和指定的所有者框架创建无模式对话框。如果owner是null ，则共享的隐藏帧将被设置为对话框的所有者。
    这个构造函数将组件的区域属性返回的值JComponent.getDefaultLocale 。
    
    注意：此构造函数不允许您创建JDialog 。要创建JDialog您必须使用参数null的JDialog(Window)或JDialog(Dialog)构造函数。
    
    参数
    
    owner -在 Frame从中显示的对话框
    
    title - 在对话框的标题栏中显示的 String
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless()返回 true 。
    
    另请参见：
    
    GraphicsEnvironment.isHeadless() ， JComponent.getDefaultLocale()
  - JDialog
```
public JDialog(Frame owner,
               String title,
               boolean modal)
```
    创建一个具有指定标题的对话框，所有者为Frame和模态。如果owner是null ， null共享的隐藏帧设置为此对话框的所有者。
    此构造函数将组件的locale属性设置为返回的值JComponent.getDefaultLocale 。
    
    注：所有弹出式组件（ JComboBox ， JPopupMenu ， JMenuBar模态对话框内创建）将被迫轻量级的。
    
    注意：此构造函数不允许您创建JDialog 。要创建一个JDialog您必须使用JDialog(Window)或JDialog(Dialog)构造函数，参数为null 。
    
    参数
    
    owner -在 Frame从中显示的对话框
    
    title - 在对话框的标题栏中显示的 String
    
    modal - 指定对话框是否显示用户输入到其他顶级窗口。如果true ，模态类型属性设置为DEFAULT_MODALITY_TYPE否则对话框是无模式的
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless()返回 true 。
    
    另请参见：
    
    Dialog.ModalityType ， Dialog.ModalityType.MODELESS ， Dialog.DEFAULT_MODALITY_TYPE ， Dialog.setModal(boolean) ， Dialog.setModalityType(java.awt.Dialog.ModalityType) ， GraphicsEnvironment.isHeadless() ， JComponent.getDefaultLocale()
  - JDialog
```
public JDialog(Frame owner,
               String title,
               boolean modal,
               GraphicsConfiguration gc)
```
    创建一个具有指定标题的对话框，所有者为Frame ，模态和GraphicsConfiguration 。如果owner为null ， null共享的隐藏帧设置为此对话框的所有者。
    这个构造函数将组件的区域属性返回的值JComponent.getDefaultLocale 。
    
    注：所有弹出式组件（ JComboBox ， JPopupMenu ， JMenuBar模态对话框内创建）将被迫轻量级的。
    
    注意：此构造函数不允许您创建JDialog 。要创建JDialog您必须使用参数null的JDialog(Window)或JDialog(Dialog)构造函数。
    
    参数
    
    owner -在 Frame从中显示的对话框
    
    title - 在对话框的标题栏中显示的 String
    
    modal - 指定对话框是否显示用户输入到其他顶级窗口。如果true ，模态类型属性设置为DEFAULT_MODALITY_TYPE ，否则对话框是无模式的。
    
    gc - 目标屏幕设备的GraphicsConfiguration ; 如果是null ，则默认系统为GraphicsConfiguration
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless()返回 true 。
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    Dialog.ModalityType ， Dialog.ModalityType.MODELESS ， Dialog.DEFAULT_MODALITY_TYPE ， Dialog.setModal(boolean) ， Dialog.setModalityType(java.awt.Dialog.ModalityType) ， GraphicsEnvironment.isHeadless() ， JComponent.getDefaultLocale()
  - JDialog
```
public JDialog(Dialog owner)
```
    创建一个无模式对话框，其中指定的是Dialog作为其所有者，并且为空标题。
    这个构造函数将组件的区域属性返回的值JComponent.getDefaultLocale 。
    
    参数
    
    owner - 显示对话框的所有者 Dialog或如果此对话框没有所有者， null
    
    异常
    
    HeadlessException - if GraphicsEnvironment.isHeadless()返回 true 。
    
    另请参见：
    
    GraphicsEnvironment.isHeadless() ， JComponent.getDefaultLocale()
  - JDialog
```
public JDialog(Dialog owner,
               boolean modal)
```
    创建一个具有空标题和指定模态的对话框，并以Dialog作为其所有者。
    这个构造函数将组件的区域属性返回的值JComponent.getDefaultLocale 。
    
    参数
    
    owner - 显示对话框的所有者 Dialog或如果此对话框没有所有者， null
    
    modal - 指定对话框是否显示用户输入到其他顶级窗口。如果true ，模态类型属性设置为DEFAULT_MODALITY_TYPE ，否则对话框是无模式的。
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless()返回 true 。
    
    另请参见：
    
    Dialog.ModalityType ， Dialog.ModalityType.MODELESS ， Dialog.DEFAULT_MODALITY_TYPE ， Dialog.setModal(boolean) ， Dialog.setModalityType(java.awt.Dialog.ModalityType) ， GraphicsEnvironment.isHeadless() ， JComponent.getDefaultLocale()
  - JDialog
```
public JDialog(Dialog owner,
               String title)
```
    使用指定的标题和指定的所有者对话框创建无模式对话框。
    这个构造函数将组件的区域属性返回的值JComponent.getDefaultLocale 。
    
    参数
    
    owner - 显示对话框的所有者 Dialog或如果此对话框没有所有者， null
    
    title - 在对话框的标题栏中显示的 String
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless()返回 true 。
    
    另请参见：
    
    GraphicsEnvironment.isHeadless() ， JComponent.getDefaultLocale()
  - JDialog
```
public JDialog(Dialog owner,
               String title,
               boolean modal)
```
    创建一个具有指定标题，模态和指定所有者的Dialog 。
    这个构造函数将组件的区域属性返回的值JComponent.getDefaultLocale 。
    
    参数
    
    owner - 显示对话框的所有者 Dialog或如果此对话框没有所有者， null
    
    title - 在对话框的标题栏中显示的 String
    
    modal - 指定对话框是否显示用户输入到其他顶级窗口。如果true ，模态类型属性设置为DEFAULT_MODALITY_TYPE ，否则对话框是无模式的
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless()返回 true 。
    
    另请参见：
    
    Dialog.ModalityType ， Dialog.ModalityType.MODELESS ， Dialog.DEFAULT_MODALITY_TYPE ， Dialog.setModal(boolean) ， Dialog.setModalityType(java.awt.Dialog.ModalityType) ， GraphicsEnvironment.isHeadless() ， JComponent.getDefaultLocale()
  - JDialog
```
public JDialog(Dialog owner,
               String title,
               boolean modal,
               GraphicsConfiguration gc)
```
    创建一个具有指定标题的对话框，所有者Dialog ，模式和GraphicsConfiguration 。
    注：所有弹出式组件（ JComboBox ， JPopupMenu ， JMenuBar模态对话框内创建）将被迫轻量级的。
    
    这个构造函数将组件的区域属性返回的值JComponent.getDefaultLocale 。
    
    参数
    
    owner - 显示对话框的所有者 Dialog或如果此对话框没有所有者， null
    
    title - 在对话框的标题栏中显示的 String
    
    modal - 指定对话框是否显示用户输入到其他顶级窗口。如果true ，模态类型属性设置为DEFAULT_MODALITY_TYPE ，否则对话框是无模式的
    
    gc - 目标屏幕设备的GraphicsConfiguration ; 如果null ，则假定默认系统为GraphicsConfiguration
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless()返回 true 。
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    Dialog.ModalityType ， Dialog.ModalityType.MODELESS ， Dialog.DEFAULT_MODALITY_TYPE ， Dialog.setModal(boolean) ， Dialog.setModalityType(java.awt.Dialog.ModalityType) ， GraphicsEnvironment.isHeadless() ， JComponent.getDefaultLocale()
  - JDialog
```
public JDialog(Window owner)
```
    创建一个无模式对话框，其中指定的Window作为其所有者，并且为空标题。
    这个构造函数将组件的区域属性返回的值JComponent.getDefaultLocale 。
    
    参数
    
    owner -在 Window从中显示该对话框或 null如果此对话框没有所有者
    
    异常
    
    IllegalArgumentException - 如果owner不是Dialog或Frame的实例
    
    IllegalArgumentException - 如果 owner的 GraphicsConfiguration不是从屏幕设备
    
    HeadlessException - 当时 GraphicsEnvironment.isHeadless()返回 true
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    GraphicsEnvironment.isHeadless() ， JComponent.getDefaultLocale()
  - JDialog
```
public JDialog(Window owner,
               Dialog.ModalityType modalityType)
```
    创建一个具有空标题和指定模态的对话框，并以Window作为其所有者。
    这个构造函数将组件的区域属性返回的值JComponent.getDefaultLocale 。
    
    参数
    
    owner -在 Window从中显示该对话框或 null如果此对话框没有所有者
    
    modalityType - 指定对话框是否在输入到其他窗口时显示。 null值和不支持的模式类型相当于MODELESS
    
    异常
    
    IllegalArgumentException - 如果owner不是Dialog或Frame的实例
    
    IllegalArgumentException - 如果 owner的 GraphicsConfiguration不是从屏幕设备
    
    HeadlessException - 当时 GraphicsEnvironment.isHeadless()返回 true
    
    SecurityException - 如果调用线程没有权限使用给定的 modalityType创建模态对话框
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    Dialog.ModalityType ， Dialog.setModal(boolean) ， Dialog.setModalityType(java.awt.Dialog.ModalityType) ， GraphicsEnvironment.isHeadless() ， JComponent.getDefaultLocale()
  - JDialog
```
public JDialog(Window owner,
               String title)
```
    使用指定的标题和所有者创建一个无模式对话框Window 。
    这个构造函数将组件的区域属性返回的值JComponent.getDefaultLocale 。
    
    参数
    
    owner -在 Window从中显示该对话框或 null如果此对话框没有所有者
    
    title - String显示在对话框的标题栏或 null如果对话没有标题
    
    异常
    
    IllegalArgumentException - 如果owner不是Dialog或Frame的实例
    
    IllegalArgumentException - 如果 owner的 GraphicsConfiguration不是从屏幕设备
    
    HeadlessException - 当 GraphicsEnvironment.isHeadless()返回 true
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    GraphicsEnvironment.isHeadless() ， JComponent.getDefaultLocale()
  - JDialog
```
public JDialog(Window owner,
               String title,
               Dialog.ModalityType modalityType)
```
    创建一个具有指定标题的对话框，所有者为Window和模态。
    这个构造函数将组件的区域属性返回的值JComponent.getDefaultLocale 。
    
    参数
    
    owner -在 Window从中显示该对话框或 null如果此对话框没有所有者
    
    title - 在对话框的标题栏或 String中显示的 null如果对话没有标题
    
    modalityType - 指定当显示的对话框是否输入到其他窗口。 null值和不支持的模式类型相当于MODELESS
    
    异常
    
    IllegalArgumentException - 如果owner不是Dialog或Frame的实例
    
    IllegalArgumentException - 如果 owner的 GraphicsConfiguration不是从屏幕设备
    
    HeadlessException - 当时 GraphicsEnvironment.isHeadless()返回 true
    
    SecurityException - 如果调用线程没有权限使用给定的 modalityType创建模态对话框
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    Dialog.ModalityType ， Dialog.setModal(boolean) ， Dialog.setModalityType(java.awt.Dialog.ModalityType) ， GraphicsEnvironment.isHeadless() ， JComponent.getDefaultLocale()
  - JDialog
```
public JDialog(Window owner,
               String title,
               Dialog.ModalityType modalityType,
               GraphicsConfiguration gc)
```
    创建一个具有指定标题的对话框，所有者为Window ，模态和GraphicsConfiguration 。
    注：所有弹出式组件（ JComboBox ， JPopupMenu ， JMenuBar模态对话框内创建）将被迫轻量级的。
    
    这个构造函数将组件的区域属性返回的值JComponent.getDefaultLocale 。
    
    参数
    
    owner -在 Window从中显示该对话框或 null如果此对话框没有所有者
    
    title - String显示在对话框的标题栏或 null如果对话没有标题
    
    modalityType - 指定对话框是否显示输入到其他窗口。 null值和不支持的模式类型相当于MODELESS
    
    gc - 目标屏幕设备的GraphicsConfiguration ; 如果是null ，则假设默认系统为GraphicsConfiguration
    
    异常
    
    IllegalArgumentException - 如果owner不是Dialog或Frame的实例
    
    IllegalArgumentException - 如果 owner的 GraphicsConfiguration不是从屏幕设备
    
    HeadlessException - 当 GraphicsEnvironment.isHeadless()返回 true
    
    SecurityException - 如果调用线程没有权限，可以使用给定的 modalityType创建模态对话框
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    Dialog.ModalityType ， Dialog.setModal(boolean) ， Dialog.setModalityType(java.awt.Dialog.ModalityType) ， GraphicsEnvironment.isHeadless() ， JComponent.getDefaultLocale()
- 方法详细信息
  - dialogInit
```
protected void dialogInit()
```
    由构造函数调用正确地初始化 JDialog 。
  - createRootPane
```
protected JRootPane createRootPane()
```
    由构造函数调用方法创建默认值 rootPane 。
  - processWindowEvent
```
protected void processWindowEvent(WindowEvent e)
```
    根据 defaultCloseOperation属性的状态处理窗口事件。
    
    重写：
    
    processWindowEvent在 Window
    
    参数
    
    e - 窗口事件
    
    另请参见：
    
    setDefaultCloseOperation(int)
  - setDefaultCloseOperation
```
public void setDefaultCloseOperation(int operation)
```
    设置用户在此对话框上启动“关闭”时默认执行的操作。您必须指定以下选项之一：
    - DO_NOTHING_ON_CLOSE （定义在WindowConstants ）：不要做任何事情; 要求程序在windowClosing方法中处理已注册的WindowListener对象的操作。
    - HIDE_ON_CLOSE （在WindowConstants定义）：在调用任何已注册的WindowListener对象后自动隐藏该对话框。
    - DISPOSE_ON_CLOSE （在WindowConstants定义）：在调用任何已注册的WindowListener对象后自动隐藏和处理对话框。
    该值默认设置为HIDE_ON_CLOSE 。对此属性的值的更改导致触发属性更改事件，属性名称为“defaultCloseOperation”。
    
    注意：当Java虚拟机（VM）中的最后一个可显示的窗口被丢弃时，VM可能会终止。见AWT Threading Issues以获取更多信息。
    参数
    
    operation - 用户关闭对话框时应执行的操作
    
    异常
    
    IllegalArgumentException - 如果defaultCloseOperation值不是上述有效值之一
    
    另请参见：
    
    Window.addWindowListener(java.awt.event.WindowListener) ， getDefaultCloseOperation() ， WindowConstants
  - getDefaultCloseOperation
```
public int getDefaultCloseOperation()
```
    返回用户在此对话框上启动“关闭”时发生的操作。
    
    结果
    
    指示窗口关闭操作的整数
    
    另请参见：
    
    setDefaultCloseOperation(int)
  - setTransferHandler
```
public void setTransferHandler(TransferHandler newHandler)
```
    设置transferHandler属性，这是一种支持将数据传输到此组件的机制。使用null如果该组件不支持数据传输操作。
    如果系统属性suppressSwingDropSupport为false （默认值），并且此组件上的当前下降目标是null或不是用户设置的下拉目标，则此方法将更改下拉目标，如下所示：如果newHandler为null ，它将清除掉目标。如果不是null它会安装一个新的DropTarget 。
    
    注意：当与JDialog一起使用时， TransferHandler仅提供数据导入功能，因为数据导出相关方法当前键入JComponent 。
    
    有关更多信息，请参阅Java Tutorial How to Use Drag and Drop and Data Transfer中的一节。
    
    参数
    
    newHandler - 全新 TransferHandler
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    TransferHandler ， getTransferHandler() ， Component.setDropTarget(java.awt.dnd.DropTarget)
  - getTransferHandler
```
public TransferHandler getTransferHandler()
```
    获得 transferHandler属性。
    
    结果
    
    的价值 transferHandler属性
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    TransferHandler ， setTransferHandler(javax.swing.TransferHandler)
  - update
```
public void update(Graphics g)
```
    致电paint(g) 。该方法被覆盖，以防止不必要的调用来清除背景。
    
    重写：
    
    update在 Container
    
    参数
    
    g - 要绘画的 Graphics上下文
    
    另请参见：
    
    Component.update(Graphics)
  - setJMenuBar
```
public void setJMenuBar(JMenuBar menu)
```
    设置此对话框的菜单栏。
    
    参数
    
    menu - 将菜单栏放在对话框中
    
    另请参见：
    
    getJMenuBar()
  - getJMenuBar
```
public JMenuBar getJMenuBar()
```
    返回此对话框上的菜单栏。
    
    另请参见：
    
    setJMenuBar(javax.swing.JMenuBar)
  - isRootPaneCheckingEnabled
```
protected boolean isRootPaneCheckingEnabled()
```
    返回是否将 add和 setLayout的电话转发到 contentPane 。
    
    结果
    
    如果add和setLayout ，则为true; 否则为假
    
    另请参见：
    
    addImpl(java.awt.Component, java.lang.Object, int) ， setLayout(java.awt.LayoutManager) ， setRootPaneCheckingEnabled(boolean) ， RootPaneContainer
  - setRootPaneCheckingEnabled
```
protected void setRootPaneCheckingEnabled(boolean enabled)
```
    设置是否向 add和 setLayout的 contentPane 。
    
    参数
    
    enabled - 如果 add和 setLayout被转发，则为true，如果它们应该直接在 JDialog上操作，则为false。
    
    另请参见：
    
    addImpl(java.awt.Component, java.lang.Object, int) ， setLayout(java.awt.LayoutManager) ， isRootPaneCheckingEnabled() ， RootPaneContainer
  - addImpl
```
protected void addImpl(Component comp,
                       Object constraints,
                       int index)
```
    添加指定的子级Component 。该方法被覆盖以有条件地转移到contentPane 。默认情况下，孩子将添加到contentPane而不是框架，详情请参考RootPaneContainer 。
    
    重写：
    
    addImpl在 Container
    
    参数
    
    comp - 要增强的组件
    
    constraints - 要遵守的约束
    
    index - 指数
    
    异常
    
    IllegalArgumentException - 如果 index无效
    
    IllegalArgumentException - 如果将容器的父项添加到自身中
    
    IllegalArgumentException - 如果向 IllegalArgumentException添加窗口
    
    另请参见：
    
    setRootPaneCheckingEnabled(boolean) ， RootPaneContainer
  - remove
```
public void remove(Component comp)
```
    从容器中删除指定的组件。如果comp不是rootPane ，这将转发到contentPane 。如果comp不是JDialog或contentPane的孩子，这将不会做任何事情。
    
    重写：
    
    remove在 Container
    
    参数
    
    comp - 要删除的组件
    
    异常
    
    NullPointerException - 如果 comp为空
    
    另请参见：
    
    Container.add(java.awt.Component) ， RootPaneContainer
  - setLayout
```
public void setLayout(LayoutManager manager)
```
    设置LayoutManager 。被覆盖以有条件地将呼叫转发到contentPane 。请参阅RootPaneContainer以获取更多信息。
    
    重写：
    
    setLayout在 Container
    
    参数
    
    manager - LayoutManager
    
    另请参见：
    
    setRootPaneCheckingEnabled(boolean) ， RootPaneContainer
  - getRootPane
```
public JRootPane getRootPane()
```
    返回此对话框的 rootPane对象。
    
    Specified by:
    
    getRootPane在界面 RootPaneContainer
    
    结果
    
    这个组件单JRootPane小孩。
    
    另请参见：
    
    setRootPane(javax.swing.JRootPane) ， RootPaneContainer.getRootPane()
  - setRootPane
```
protected void setRootPane(JRootPane root)
```
    设置rootPane属性。该方法由构造函数调用。
    
    参数
    
    root - 此对话框的 rootPane对象
    
    另请参见：
    
    getRootPane()
  - getContentPane
```
public Container getContentPane()
```
    返回此对话框的 contentPane对象。
    
    Specified by:
    
    getContentPane在接口 RootPaneContainer
    
    结果
    
    contentPane属性
    
    另请参见：
    
    setContentPane(java.awt.Container) ， RootPaneContainer.getContentPane()
  - setContentPane
```
public void setContentPane(Container contentPane)
```
    设置contentPane属性。该方法由构造函数调用。
    Swing的绘画架构在遏制层次JComponent中需要一个不透明的JComponent。这通常由内容窗格提供。如果更换内容窗格，建议您将其替换为不透明的JComponent 。
    
    Specified by:
    
    setContentPane在界面 RootPaneContainer
    
    参数
    
    contentPane - 此对话框的 contentPane对象
    
    异常
    
    IllegalComponentStateException - （运行时异常）如果内容窗格参数为 null
    
    另请参见：
    
    JRootPane ， getContentPane() ， RootPaneContainer.setContentPane(java.awt.Container)
  - getLayeredPane
```
public JLayeredPane getLayeredPane()
```
    返回此对话框的 layeredPane对象。
    
    Specified by:
    
    getLayeredPane在界面 RootPaneContainer
    
    结果
    
    layeredPane属性
    
    另请参见：
    
    setLayeredPane(javax.swing.JLayeredPane) ， RootPaneContainer.getLayeredPane()
  - setLayeredPane
```
public void setLayeredPane(JLayeredPane layeredPane)
```
    设置layeredPane属性。该方法由构造函数调用。
    
    Specified by:
    
    setLayeredPane在接口 RootPaneContainer
    
    参数
    
    layeredPane - 新的 layeredPane属性
    
    异常
    
    IllegalComponentStateException - （运行时异常）如果分层窗格参数为空
    
    另请参见：
    
    getLayeredPane() ， RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)
  - getGlassPane
```
public Component getGlassPane()
```
    返回此对话框的 glassPane对象。
    
    Specified by:
    
    getGlassPane在接口 RootPaneContainer
    
    结果
    
    glassPane财产
    
    另请参见：
    
    setGlassPane(java.awt.Component) ， RootPaneContainer.getGlassPane()
  - setGlassPane
```
public void setGlassPane(Component glassPane)
```
    设置glassPane属性。该方法由构造函数调用。
    
    Specified by:
    
    setGlassPane在接口 RootPaneContainer
    
    参数
    
    glassPane - 此对话框的 glassPane对象
    
    另请参见：
    
    getGlassPane() ， RootPaneContainer.setGlassPane(java.awt.Component)
  - getGraphics
```
public Graphics getGraphics()
```
    为此组件创建图形上下文。此方法将返回null如果组件当前是不可显示。
    
    重写：
    
    getGraphics在 Component类
    
    结果
    
    这个组件的图形上下文，如果没有， null
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    Component.paint(java.awt.Graphics)
  - repaint
```
public void repaint(long time,
                    int x,
                    int y,
                    int width,
                    int height)
```
    在time毫秒内time绘制该组件的time矩形。有关如何处理重绘的详细信息，请参阅RepaintManager 。
    
    重写：
    
    repaint在 Component
    
    参数
    
    time - 更新前的最大时间（毫秒）
    
    x - x坐标
    
    y - y坐标
    
    width - 宽度
    
    height - 高度
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    RepaintManager
  - setDefaultLookAndFeelDecorated
```
public static void setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated)
```
    提供一个提示，以确定新创建的JDialog是否应该有当前的外观和风格提供的窗口装饰（如边框，关闭窗口，标题...）。如果defaultLookAndFeelDecorated是真的，当前的LookAndFeel支持提供窗口装饰，当前的窗口管理器支持未装饰的窗口，那么新创建的JDialog的窗口装饰将由当前的LookAndFeel 。否则，新创建的JDialog将具有由当前窗口管理器提供的窗口装饰。
    您可以通过执行以下操作在单个JDialog上获得相同的效果：
```
  JDialog dialog = new JDialog();
    dialog.setUndecorated(true);
    dialog.getRootPane().setWindowDecorationStyle(JRootPane.PLAIN_DIALOG); 
```
    参数
    
    defaultLookAndFeelDecorated - 关于当前的外观是否应提供窗饰的提示
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    LookAndFeel.getSupportsWindowDecorations()
  - isDefaultLookAndFeelDecorated
```
public static boolean isDefaultLookAndFeelDecorated()
```
    如果新创建的JDialog应该具有当前外观提供的窗口装饰，则返回true。这只是一个提示，因为某些外观和感觉可能不支持此功能。
    
    结果
    
    真实如果外观和感觉应该提供Window装饰。
    
    从以下版本开始：
    
    1.4
  - paramString
```
protected String paramString()
```
    返回此JDialog的字符串表示JDialog 。该方法仅用于调试目的，并且返回的字符串的内容和格式可能因实现而异。返回的字符串可能为空，但可能不是null 。
    
    重写：
    
    paramString在 Dialog
    
    结果
    
    这个 JDialog的字符串表示 JDialog 。
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    获取与此JDialog关联的AccessibleContext。对于JDialog，AccessibleContext采用AccessibleJDialog的形式。如有必要，将创建一个新的AccessibleJDialog实例。
    
    Specified by:
    
    getAccessibleContext在接口 Accessible
    
    重写：
    
    getAccessibleContext在 Dialog
    
    结果
    
    AccessibleJDialog用作此JDialog的AccessibleContext

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class JDialog

Nested Class Summary

Nested classes/interfaces inherited from class java.awt.Dialog

Nested classes/interfaces inherited from class java.awt.Window

Nested classes/interfaces inherited from class java.awt.Container

Nested classes/interfaces inherited from class java.awt.Component

Field Summary

Fields inherited from class java.awt.Dialog

Fields inherited from class java.awt.Component

Fields inherited from interface javax.swing.WindowConstants

Fields inherited from interface java.awt.image.ImageObserver

构造方法摘要

方法摘要

Methods inherited from class java.awt.Dialog

Methods inherited from class java.awt.Window

Methods inherited from class java.awt.Container

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

字段详细信息

rootPane

rootPaneCheckingEnabled

accessibleContext

构造方法详细信息

JDialog

JDialog

JDialog

JDialog

JDialog

JDialog

JDialog

JDialog

JDialog

JDialog

JDialog

JDialog

JDialog

JDialog

JDialog

JDialog

方法详细信息

dialogInit

createRootPane

processWindowEvent

setDefaultCloseOperation

getDefaultCloseOperation

setTransferHandler

getTransferHandler

update

setJMenuBar

getJMenuBar

isRootPaneCheckingEnabled

setRootPaneCheckingEnabled

addImpl

remove

setLayout

getRootPane

setRootPane

getContentPane

setContentPane

getLayeredPane

setLayeredPane

getGlassPane

setGlassPane

getGraphics

repaint

setDefaultLookAndFeelDecorated

isDefaultLookAndFeelDecorated

paramString

getAccessibleContext