javax.swing
类 JDialog

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

所有已实现的接口：

ImageObserver, MenuContainer, Serializable, Accessible, RootPaneContainer, WindowConstants

public class JDialog
extends Dialog
implements WindowConstants, Accessible, RootPaneContainer

创建对话框窗口的主要类。可以使用此类创建自定义的对话框，或者调用 JOptionPane 中的多个类方法来创建各种标准对话框。有关创建对话框的信息，请参阅《The Java Tutorial》中的 How to Make Dialogs 一节。

JDialog 组件包含一个 JRootPane 作为其惟一的子组件。contentPane 应该是所有 JDialog 子组件的父级。为了方便使用 add 及其变体，已经重写了 remove 和 setLayout，以在必要时将其转发到 contentPane。这意味着可以编写：

       dialog.add(child);
 

将子级添加到 contentPane。contentPane 始终是非 null 的。试图将其设置为 null 会生成异常。默认的 contentPane 有一个 BorderLayout 管理器。有关添加、移除和设置 JDialog 的 LayoutManager 的更多信息，请参阅 RootPaneContainer。

有关 contentPane、glassPane 和 layeredPane 组件的完整描述，请参阅 JRootPane 文档。

在多屏幕环境中，可以在不同于其所有者的屏幕设备上创建一个 JDialog。有关更多信息，请参阅 Frame。

警告：此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 XMLEncoder。

另请参见：

JOptionPane, JRootPane, RootPaneContainer

嵌套类摘要

protected class

JDialog.AccessibleJDialog 此类实现对 JDialog 类的可访问性支持。

从类 java.awt.Dialog 继承的嵌套类/接口

Dialog.AccessibleAWTDialog

从类 java.awt.Window 继承的嵌套类/接口

Window.AccessibleAWTWindow

从类 java.awt.Container 继承的嵌套类/接口

Container.AccessibleAWTContainer

从类 java.awt.Component 继承的嵌套类/接口

Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy

字段摘要

protected AccessibleContext	accessibleContext
protected JRootPane	rootPane
protected boolean	rootPaneCheckingEnabled 如果为 true，则将对 add 和 setLayout 的调用转发到 contentPane。

从类 java.awt.Component 继承的字段

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

从接口 javax.swing.WindowConstants 继承的字段

DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE

从接口 java.awt.image.ImageObserver 继承的字段

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

构造方法摘要

JDialog()
创建一个没有标题并且没有指定 Frame 所有者的无模式对话框。

JDialog(Dialog owner)
创建一个没有标题但将指定的 Dialog 作为其所有者的无模式对话框。

JDialog(Dialog owner, boolean modal)
创建一个没有标题但有指定所有者对话框的有模式或无模式对话框。

JDialog(Dialog owner, String title)
创建一个具有指定标题和指定所有者对话框的无模式对话框。

JDialog(Dialog owner, String title, boolean modal)
创建一个具有指定标题和指定所有者对话框的有模式或无模式对话框。

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 的有模式或无模式对话框。

方法摘要

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() 返回用户在此对话框上发起 "close" 时所执行的操作。
Component	getGlassPane() 返回此对话框的 glassPane 对象。
JMenuBar	getJMenuBar() 返回此对话框上设置的菜单栏。
JLayeredPane	getLayeredPane() 返回此对话框的 layeredPane 对象。
JRootPane	getRootPane() 返回此对话框的 rootPane 对象。
static boolean	isDefaultLookAndFeelDecorated() 如果应该通过当前的外观为新创建的 JDialog 提供其 Window 装饰，则返回 true。
protected boolean	isRootPaneCheckingEnabled() 返回是否将对 add 和 setLayout 的调用转发到 contentPane。
protected String	paramString() 返回此 JDialog 的字符串表示形式。
protected void	processWindowEvent(WindowEvent e) 根据 defaultCloseOperation 属性的状态处理窗口事件。
void	remove(Component comp) 从该容器中移除指定组件。
void	setContentPane(Container contentPane) 设置 contentPane 属性。
void	setDefaultCloseOperation(int operation) 设置当用户在此对话框上发起 "close" 时默认执行的操作。
static void	setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated) 提供一个关于是否应该通过当前的外观为新创建的 JDialog 提供其 Window 装饰（如边界、关闭窗口的小部件、标题……）的提示。
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	update(Graphics g) 调用 paint(g)。

从类 java.awt.Dialog 继承的方法

addNotify, getTitle, hide, isModal, isResizable, isUndecorated, setModal, setResizable, setTitle, setUndecorated, show

从类 java.awt.Window 继承的方法

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, finalize, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getMostRecentFocusOwner, getOwnedWindows, getOwner, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindowStateListeners, isActive, isAlwaysOnTop, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, setAlwaysOnTop, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setLocationByPlatform, setLocationRelativeTo, toBack, toFront

从类 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, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusBackward, transferFocusDownCycle, validate, validateTree

从类 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, getBackground, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, 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, isOpaque, 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, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, size, toString, transferFocus, transferFocusUpCycle

从类 java.lang.Object 继承的方法

clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

字段详细信息

rootPane

protected JRootPane rootPane

另请参见：

getRootPane(), setRootPane(javax.swing.JRootPane)

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled

如果为 true，则将对 add 和 setLayout 的调用转发到 contentPane。此方法初始为 false，但在构造 JDialog 时将其设置为 true。

另请参见：

isRootPaneCheckingEnabled(), setRootPaneCheckingEnabled(boolean), RootPaneContainer

accessibleContext

protected AccessibleContext accessibleContext

构造方法详细信息

JDialog

public JDialog()
        throws HeadlessException

创建一个没有标题并且没有指定 Frame 所有者的无模式对话框。将一个共享的、隐藏的窗体设置为该对话框的所有者。

此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale 所返回的值。

抛出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另请参见：

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Frame owner)
        throws HeadlessException

创建一个没有标题但将指定的 Frame 作为其所有者的无模式对话框。如果 owner 为 null，则将一个共享的、隐藏的窗体设置为该对话框的所有者。

此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale 所返回的值。

参数：

owner - 显示该对话框的 Frame

抛出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另请参见：

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Frame owner,
               boolean modal)
        throws HeadlessException

创建一个没有标题但有指定所有者 Frame 的有模式或无模式对话框。如果 owner 为 null，则将一个共享的、隐藏的窗体设置为该对话框的所有者。

此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale 所返回的值。

参数：

owner - 显示该对话框的 Frame

modal - 为 true 时是有模式对话框，false 时允许其他窗口同时处于激活状态

抛出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另请参见：

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Frame owner,
               String title)
        throws HeadlessException

创建一个具有指定标题和指定所有者窗体的无模式对话框。如果 owner 为 null，则将一个共享的、隐藏的窗体设置为该对话框的所有者。

此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale 所返回的值。

参数：

owner - 显示该对话框的 Frame

title - 该对话框的标题栏中所显示的 String

抛出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另请参见：

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Frame owner,
               String title,
               boolean modal)
        throws HeadlessException

创建一个具有指定标题和指定所有者 Frame 的有模式或无模式对话框。如果 owner 为 null，则将一个共享的、隐藏的窗体设置为该对话框的所有者。所有构造方法都服从这一规定。

注：强制要求在有模式对话框中所创建的所有弹出式组件（JComboBox、JPopupMenu、JMenuBar）都是轻量级的。

此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale 所返回的值。

参数：

owner - 显示该对话框的 Frame

title - 该对话框的标题栏中所显示的 String

modal - 为 true 时是有模式对话框，false 时允许其他窗口同时处于激活状态

抛出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另请参见：

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Frame owner,
               String title,
               boolean modal,
               GraphicsConfiguration gc)

创建一个具有指定标题、指定所有者 Frame 和 GraphicsConfiguration 的有模式或无模式对话框。

注：强制要求在有模式对话框中所创建的所有弹出式组件（JComboBox、JPopupMenu、JMenuBar）都是轻量级的。

此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale 所返回的值。

参数：

owner - 显示该对话框的 Frame

title - 该对话框的标题栏中所显示的 String

modal - 为 true 时是有模式对话框，false 时允许其他窗口同时处于激活状态

gc - 目标屏幕设备的 GraphicsConfiguration。如果 gc 为 null，则使用与 Frame 相同的 GraphicsConfiguration。

抛出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

从以下版本开始：

1.4

另请参见：

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Dialog owner)
        throws HeadlessException

创建一个没有标题但将指定的 Dialog 作为其所有者的无模式对话框。

此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale 所返回的值。

参数：

owner - 显示该对话框的非 null Frame

抛出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另请参见：

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Dialog owner,
               boolean modal)
        throws HeadlessException

创建一个没有标题但有指定所有者对话框的有模式或无模式对话框。

此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale 所返回的值。

参数：

owner - 显示该对话框的非 null Dialog

modal - 为 true 时是有模式对话框，false 时允许其他窗口同时处于激活状态

抛出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另请参见：

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Dialog owner,
               String title)
        throws HeadlessException

创建一个具有指定标题和指定所有者对话框的无模式对话框。

此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale 所返回的值。

参数：

owner - 显示该对话框的非 null Dialog

title - 该对话框的标题栏中所显示的 String

抛出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另请参见：

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Dialog owner,
               String title,
               boolean modal)
        throws HeadlessException

创建一个具有指定标题和指定所有者对话框的有模式或无模式对话框。

此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale 所返回的值。

参数：

owner - 显示该对话框的非 null Dialog

title - 该对话框的标题栏中所显示的 String

modal - true 时是有模式对话框，false 时允许其他窗口同时处于激活状态

抛出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另请参见：

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JDialog

public JDialog(Dialog owner,
               String title,
               boolean modal,
               GraphicsConfiguration gc)
        throws HeadlessException

创建一个具有指定标题、所有者 Dialog 和 GraphicsConfiguration 的有模式或无模式对话框。

注：强制要求在有模式对话框中所创建的所有弹出式组件（JComboBox、JPopupMenu、JMenuBar）都是轻量级的。

此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale 所返回的值。

参数：

owner - 显示该对话框的 Dialog

title - 该对话框的标题栏中所显示的 String

modal - 为 true 时是有模式对话框，false 时允许其他窗口同时处于激活状态

gc - 目标屏幕设备的 GraphicsConfiguration。如果 gc 为 null，则使用与 Dialog 相同的 GraphicsConfiguration。

抛出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

从以下版本开始：

1.4

另请参见：

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

方法详细信息

dialogInit

protected void dialogInit()

构造方法调用此方法来正确初始化 JDialog。

createRootPane

protected JRootPane createRootPane()

构造方法调用此方法来创建默认的 rootPane。

processWindowEvent

protected void processWindowEvent(WindowEvent e)

根据 defaultCloseOperation 属性的状态处理窗口事件。

覆盖：

类 Window 中的 processWindowEvent

参数：

e - 窗口事件

另请参见：

setDefaultCloseOperation(int)

setDefaultCloseOperation

public void setDefaultCloseOperation(int operation)

设置当用户在此对话框上发起 "close" 时默认执行的操作。可能的选项为：

• DO_NOTHING_ON_CLOSE - 不执行任何操作，需要程序在已注册的 WindowListener 对象的 windowClosing 方法中处理该操作。
• HIDE_ON_CLOSE - 调用任意已注册的 WindowListener 对象后自动隐藏该对话框
• DISPOSE_ON_CLOSE - 调用任意已注册的 WindowListener 对象后自动隐藏并处置该对话框

默认将该值设置为 HIDE_ON_CLOSE。

注：当 Java 虚拟机 (VM) 中最后的可显示窗口被移除后，虚拟机可能会终止。有关更多信息，请参阅 AWT Threading Issues。

另请参见：

Window.addWindowListener(java.awt.event.WindowListener), getDefaultCloseOperation()

getDefaultCloseOperation

public int getDefaultCloseOperation()

返回用户在此对话框上发起 "close" 时所执行的操作。

返回：

一个指示窗口关闭操作的整数

另请参见：

setDefaultCloseOperation(int)

update

public void update(Graphics g)

调用 paint(g)。重写此方法，以防止不必要的清除背景调用。

覆盖：

类 Container 中的 update

参数：

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；否则返回 false

另请参见：

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。

覆盖：

类 Container 中的 addImpl

参数：

comp - 子组件所添加到的组件

constraints - 要遵守的约束条件

index - 索引

抛出：

IllegalArgumentException - 如果 index 无效

IllegalArgumentException - 如果将容器的父级添加到其本身

IllegalArgumentException - 如果向容器内添加窗口

另请参见：

setRootPaneCheckingEnabled(boolean), RootPaneContainer

remove

public void remove(Component comp)

从该容器中移除指定组件。如果 comp 不是 rootPane，则将该调用转发到 contentPane。如果 comp 不是 JDialog 或 contentPane 的子级，则不执行任何操作。

覆盖：

类 Container 中的 remove

参数：

comp - 要移除的组件

抛出：

NullPointerException - 如果 comp 为 null

另请参见：

Container.add(java.awt.Component), RootPaneContainer

setLayout

public void setLayout(LayoutManager manager)

设置 LayoutManager。重写此方法，以有条件地将调用转发到 contentPane。有关此内容的更多信息，请参阅 RootPaneContainer。

覆盖：

类 Container 中的 setLayout

参数：

manager - the LayoutManager

另请参见：

setRootPaneCheckingEnabled(boolean), RootPaneContainer

getRootPane

public JRootPane getRootPane()

返回此对话框的 rootPane 对象。

指定者：

接口 RootPaneContainer 中的 getRootPane

返回：

此组件的单个 JRootPane 子组件。

另请参见：

setRootPane(javax.swing.JRootPane), RootPaneContainer.getRootPane()

setRootPane

protected void setRootPane(JRootPane root)

设置 rootPane 属性。此方法由构造方法调用。

参数：

root - 此对话框的 rootPane 对象

另请参见：

getRootPane()

getContentPane

public Container getContentPane()

返回此对话框的 contentPane 对象。

指定者：

接口 RootPaneContainer 中的 getContentPane

返回：

contentPane 属性

另请参见：

setContentPane(java.awt.Container), RootPaneContainer.getContentPane()

setContentPane

public void setContentPane(Container contentPane)

设置 contentPane 属性。此方法由构造方法调用。

Swing 的绘制架构要求在包含层次结构中有不透明的 JComponent。这通常由内容窗格提供。如果要替换内容窗格，建议用不透明的 JComponent 替换它。

指定者：

接口 RootPaneContainer 中的 setContentPane

参数：

contentPane - 此对话框的 contentPane 对象

抛出：

IllegalComponentStateException - （运行时异常）如果 contentPane 参数为 null

另请参见：

JRootPane, getContentPane(), RootPaneContainer.setContentPane(java.awt.Container)

getLayeredPane

public JLayeredPane getLayeredPane()

返回此对话框的 layeredPane 对象。

指定者：

接口 RootPaneContainer 中的 getLayeredPane

返回：

layeredPane 属性

另请参见：

setLayeredPane(javax.swing.JLayeredPane), RootPaneContainer.getLayeredPane()

setLayeredPane

public void setLayeredPane(JLayeredPane layeredPane)

设置 layeredPane 属性。此方法由构造方法调用。

指定者：

接口 RootPaneContainer 中的 setLayeredPane

参数：

layeredPane - 新的 layeredPane 属性

抛出：

IllegalComponentStateException - （运行时异常）如果 layeredPane 参数为 null

另请参见：

getLayeredPane(), RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)

getGlassPane

public Component getGlassPane()

返回此对话框的 glassPane 对象。

指定者：

接口 RootPaneContainer 中的 getGlassPane

返回：

glassPane 属性

另请参见：

setGlassPane(java.awt.Component), RootPaneContainer.getGlassPane()

setGlassPane

public void setGlassPane(Component glassPane)

设置 glassPane 属性。此方法由构造方法调用。

指定者：

接口 RootPaneContainer 中的 setGlassPane

参数：

glassPane - 此对话框的 glassPane 对象

另请参见：

getGlassPane(), RootPaneContainer.setGlassPane(java.awt.Component)

setDefaultLookAndFeelDecorated

public static void setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated)

提供一个关于是否应该通过当前的外观为新创建的 JDialog 提供其 Window 装饰（如边界、关闭窗口的小部件、标题……）的提示。如果 defaultLookAndFeelDecorated 为 true、当前的 LookAndFeel 支持提供窗口装饰，并且当前的窗口管理器支持未装饰的窗口，则通过当前的 LookAndFeel 为新创建的 JDialog 提供其 Window 装饰。否则，通过当前的窗口管理器为新创建的 JDialog 提供其 Window 装饰。

执行下列操作可在单个 JDialog 上获得相同的效果：

    JDialog dialog = new JDialog();
    dialog.setUndecorated(true);
    dialog.getRootPane().setWindowDecorationStyle(JRootPane.PLAIN_DIALOG);
 

参数：

defaultLookAndFeelDecorated - 关于当前外观是否应该提供 window 装饰的提示

从以下版本开始：

1.4

另请参见：

LookAndFeel.getSupportsWindowDecorations()

isDefaultLookAndFeelDecorated

public static boolean isDefaultLookAndFeelDecorated()

如果应该通过当前的外观为新创建的 JDialog 提供其 Window 装饰，则返回 true。这只是一个提示，因为某些外观可能不支持此功能。

返回：

如果外观应该提供 Window 装饰，则返回 true。

从以下版本开始：

1.4

paramString

protected String paramString()

返回此 JDialog 的字符串表示形式。此方法仅在进行调试的时候使用，对于各个实现，所返回字符串的内容和格式可能有所不同。返回的字符串可能为空，但不可能为 null。

覆盖：

类 Dialog 中的 paramString

返回：

此 JDialog 的字符串表示形式。

getAccessibleContext

public AccessibleContext getAccessibleContext()

获得与此 JDialog 关联的 AccessibleContext。对于 JDialog 来说，AccessibleContext 采用 AccessibleJDialog 的形式。如有必要，可创建一个新的 AccessibleJDialog 实例。

指定者：

接口 Accessible 中的 getAccessibleContext

覆盖：

类 Dialog 中的 getAccessibleContext

返回：

一个 AccessibleJDialog，它充当此 JDialog 的 AccessibleContext