Module java.desktop

Package javax.swing

Class 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

       @JavaBean(defaultProperty="JMenuBar", description="A toplevel window for creating dialog boxes.") public class JDialog extends Dialog implements WindowConstants, Accessible, RootPaneContainer
      

创建对话框窗口的主要类。您可以使用此类来创建自定义对话框，或调用JOptionPane中的许多类方法来创建各种标准对话框。有关创建对话框的信息，请参见The Java Tutorial部分如何创建对话框。

JDialog组件包含一个JRootPane作为其唯一子级。contentPane应该是JDialog的任何子级的父级。作为一种便利，此类的add、remove和setLayout方法被重写，以便它们将调用委托给ContentPane的相应方法。例如，您可以按如下方式向对话框添加子组件：

       dialog.add(child);
 

然后子组件将被添加到contentPane。contentPane始终不为null。尝试将其设置为null会生成异常。默认的contentPane具有BorderLayout管理器设置在其上。有关添加、删除和设置JDialog的LayoutManager的详细信息，请参阅RootPaneContainer。

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

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

警告: Swing不是线程安全的。有关更多信息，请参见Swing的线程策略。

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

自:

1.2

参见:

• JOptionPane
• JRootPane
• RootPaneContainer

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected class	JDialog.AccessibleJDialog	该类为JDialog类实现了辅助功能支持。

Nested classes/interfaces declared in class java.awt.Dialog

Dialog.AccessibleAWTDialog, Dialog.ModalExclusionType, Dialog.ModalityType

Nested classes/interfaces declared in class java.awt.Window

Window.AccessibleAWTWindow, Window.Type

Nested classes/interfaces declared in class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces declared in class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field	Description
protected AccessibleContext	accessibleContext	与此JDialog关联的AccessibleContext。
protected JRootPane	rootPane	管理contentPane的JRootPane实例。
protected boolean	rootPaneCheckingEnabled	如果为true，则对add和setLayout的调用将转发到contentPane。

Fields declared in class java.awt.Dialog

DEFAULT_MODALITY_TYPE

Fields declared in class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields declared in interface java.awt.image.ImageObserver

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

Fields declared in interface javax.swing.WindowConstants

DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE

Constructor Summary

Constructors

Constructor	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的对话框。

Method Summary

Modifier and Type	Method	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的字符串表示形式。
protected void	processWindowEvent(WindowEvent e)	根据defaultCloseOperation属性的状态处理窗口事件。
void	remove(Component comp)	从容器中移除指定的组件。
void	repaint(long time, int x, int y, int width, int height)	在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 declared in class java.awt.Dialog

addNotify, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setModal, setModalityType, setResizable, setTitle, setUndecorated, setVisible, show, toBack

Methods declared in 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, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBackground, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setOpacity, setShape, setSize, setSize, setType, toFront

Methods declared in 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, removeNotify, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, validate, validateTree

Methods declared in 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, 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, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setMixingCutoutShape, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods declared in class java.lang.Object

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

Field Details

rootPane

             protected JRootPane rootPane
            

管理contentPane的JRootPane实例。

参见:

• 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关联的AccessibleContext。

Constructor Details

JDialog

             public JDialog()
            

创建一个无标题且没有指定Frame所有者的非模态对话框。将设置一个共享的隐藏框架作为对话框的所有者。

此构造方法将组件的locale属性设置为JComponent.getDefaultLocale返回的值。

注意: 此构造方法不允许您创建一个无所有者的JDialog。要创建无所有者的JDialog，必须使用带有null参数的JDialog(Window)或JDialog(Dialog)构造方法之一。

抛出:

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，则会将一个共享的隐藏框架设置为对话框的所有者。

此构造函数将组件的区域设置为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，则会将一个共享的隐藏框架设置为此对话框的所有者。

此构造函数将组件的区域设置为JComponent.getDefaultLocale返回的值。

注意：在模态对话框中创建的任何弹出组件（JComboBox、JPopupMenu、JMenuBar）将被强制成为轻量级组件。

注意：此构造函数不允许您创建一个无所有者的JDialog。要创建一个无所有者的JDialog，必须使用带有null参数的JDialog(Window)或JDialog(Dialog)构造函数。

参数：

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，则会将一个共享的隐藏框架设置为此对话框的所有者。

此构造函数将组件的区域设置为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 - 如果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版本起:

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版本起:

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版本起:

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()

Method Details

dialogInit

             protected void dialogInit()
            

由构造函数调用以正确初始化JDialog。

createRootPane

             protected JRootPane createRootPane()
            

由构造方法调用以创建默认的rootPane。

返回:

一个新的JRootPane

processWindowEvent

             protected void processWindowEvent(WindowEvent e)
            

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

覆盖:

processWindowEvent 在类 Window

参数:

e - 窗口事件

参见:

• setDefaultCloseOperation(int)

setDefaultCloseOperation

             @BeanProperty(preferred=true, enumerationValues={"WindowConstants.DO_NOTHING_ON_CLOSE","WindowConstants.HIDE_ON_CLOSE","WindowConstants.DISPOSE_ON_CLOSE"}, description="The dialog\'s default close operation.") public void setDefaultCloseOperation(int operation)
            

设置用户在此对话框上启动“关闭”时默认会发生的操作。必须指定以下选择之一：

• DO_NOTHING_ON_CLOSE（在WindowConstants中定义）：不执行任何操作；要求程序在注册的WindowListener对象的windowClosing方法中处理操作。
• HIDE_ON_CLOSE（在WindowConstants中定义）：调用任何注册的WindowListener对象后自动隐藏对话框。
• DISPOSE_ON_CLOSE（在WindowConstants中定义）：调用任何注册的WindowListener对象后自动隐藏和释放对话框。

默认值为HIDE_ON_CLOSE。更改此属性的值会导致触发属性更改事件，属性名称为“defaultCloseOperation”。

注意：当Java虚拟机（VM）中的最后一个可显示窗口被释放时，VM可能会终止。有关更多信息，请参阅 AWT线程问题。

参数:

operation - 用户关闭对话框时应执行的操作

抛出:

IllegalArgumentException - 如果defaultCloseOperation值不是上述有效值之一

参见:

• Window.addWindowListener(java.awt.event.WindowListener)
• getDefaultCloseOperation()
• WindowConstants

getDefaultCloseOperation

             public int getDefaultCloseOperation()
            

返回用户在此对话框上启动“关闭”时发生的操作。

返回:

指示窗口关闭操作的整数

参见:

• setDefaultCloseOperation(int)

setTransferHandler

             @BeanProperty(hidden=true, description="Mechanism for transfer of data into the component") public void setTransferHandler(TransferHandler newHandler)
            

设置transferHandler属性，这是支持将数据传输到此组件的机制。如果组件不支持数据传输操作，请使用null。

如果系统属性suppressSwingDropSupport为false（默认值），并且此组件上的当前放置目标为null或不是用户设置的放置目标，则此方法将更改放置目标如下：如果newHandler为null，它将清除放置目标。如果不为null，它将安装一个新的DropTarget。

注意：与JDialog一起使用时，TransferHandler仅提供数据导入功能，因为数据导出相关方法当前针对JComponent。

请参阅如何使用拖放和数据传输，这是The Java Tutorial中的一个部分，获取更多信息。

参数:

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

             @BeanProperty(bound=false, hidden=true, description="The menubar for accessing pulldown menus from this dialog.") 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

             @BeanProperty(hidden=true, description="Whether the add and setLayout methods are forwarded") protected void setRootPaneCheckingEnabled(boolean enabled)
            

设置是否将 add 和 setLayout 的调用转发到 contentPane。

参数:

enabled - 如果将 add 和 setLayout 转发，则为 true；否则应直接在 JDialog 上操作。

参见:

• 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 - 如果将窗口添加到容器

参见:

• setRootPaneCheckingEnabled(boolean)
• RootPaneContainer

remove

             public void remove(Component comp)
            

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

覆盖:

remove 在类 Container

参数:

comp - 要移除的组件

抛出:

NullPointerException - 如果 comp 为 null

参见:

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

setLayout

             public void setLayout(LayoutManager manager)
            

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

覆盖:

setLayout 在类 Container

参数:

manager - LayoutManager

参见:

• setRootPaneCheckingEnabled(boolean)
• RootPaneContainer

getRootPane

             @BeanProperty(bound=false, hidden=true, description="the RootPane object for this dialog.") public JRootPane getRootPane()
            

返回此对话框的 rootPane 对象。

指定者:

getRootPane 在接口 RootPaneContainer

返回:

此组件的单个 JRootPane 子项。

参见:

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

setRootPane

             protected void setRootPane(JRootPane root)
            

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

参数:

root - 此对话框的 rootPane 对象

参见:

• getRootPane()

getContentPane

             public Container getContentPane()
            

返回此对话框的 contentPane 对象。

指定者:

getContentPane 在接口 RootPaneContainer

返回:

contentPane 属性

参见:

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

setContentPane

             @BeanProperty(bound=false, hidden=true, description="The client area of the dialog where child components are normally inserted.") public void setContentPane(Container contentPane)
            

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

Swing 的绘制架构要求在包含层次结构中存在一个不透明的 JComponent。通常由内容窗格提供。如果替换内容窗格，则建议将其替换为不透明的 JComponent。

指定者:

setContentPane 在接口 RootPaneContainer

参数:

contentPane - 此对话框的 contentPane 对象

抛出:

IllegalComponentStateException - （运行时异常）如果内容窗格参数为 null

参见:

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

getLayeredPane

             public JLayeredPane getLayeredPane()
            

返回此对话框的 layeredPane 对象。

指定由:

getLayeredPane 在接口 RootPaneContainer

返回:

layeredPane 属性

参见:

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

setLayeredPane

             @BeanProperty(bound=false, hidden=true, description="The pane which holds the various dialog layers.") public void setLayeredPane(JLayeredPane layeredPane)
            

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

指定由:

setLayeredPane 在接口 RootPaneContainer

参数:

layeredPane - 新的layeredPane属性

抛出:

IllegalComponentStateException - (运行时异常) 如果分层窗格参数为null

参见:

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

getGlassPane

             public Component getGlassPane()
            

返回此对话框的glassPane对象。

指定由:

getGlassPane 在接口 RootPaneContainer

返回:

glassPane属性

参见:

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

setGlassPane

             @BeanProperty(bound=false, hidden=true, description="A transparent pane used for menu rendering.") public void setGlassPane(Component glassPane)
            

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

指定由:

setGlassPane 在接口 RootPaneContainer

参数:

glassPane - 此对话框的glassPane对象

参见:

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

getGraphics

             @BeanProperty(bound=false) 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毫秒内重新绘制此组件的指定矩形。有关重绘如何处理的详细信息，请参阅RepaintManager。

覆盖:

repaint 在类 Component

参数:

time - 更新前的最大时间（毫秒）

x - x坐标

y - y坐标

width - 宽度

height - 高度

自:

1.6

参见:

• RepaintManager

setDefaultLookAndFeelDecorated

             public static void setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated)
            

提供一个提示，指示新创建的JDialog是否应由当前外观提供其窗口装饰（例如边框、关闭窗口的小部件、标题等）。如果defaultLookAndFeelDecorated为true，则当前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。这只是一个提示，因为某些外观可能不支持此功能。

返回:

如果外观应提供窗口装饰，则返回true。

自:

1.4

paramString

             protected String paramString()
            

返回此JDialog的字符串表示形式。此方法仅用于调试目的，返回的字符串的内容和格式可能因实现而异。返回的字符串可能为空，但不能为null。

覆盖:

paramString 在类 Dialog

返回:

此JDialog的字符串表示形式。

getAccessibleContext

             public AccessibleContext getAccessibleContext()
            

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

指定由:

getAccessibleContext 在接口 Accessible

覆盖:

getAccessibleContext 在类 Dialog

返回:

作为此JDialog的AccessibleContext的AccessibleJDialog