- 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
@JavaBean(defaultProperty="JMenuBar", description="A toplevel window for creating dialog boxes.") public class JDialog extends Dialog implements WindowConstants, Accessible, RootPaneContainer
创建对话窗口的主要类。 您可以使用此类创建自定义对话框,或者在JOptionPane
中调用许多类方法来创建各种标准对话框。 有关创建对话框的信息,请参阅Java教程部分How to Make Dialogs 。JDialog
组件包含一个JRootPane
作为其唯一的孩子。contentPane
应该是contentPane
的任何孩子的JDialog
。 为方便起见,add
remove
和setLayout
和setLayout
方法被覆盖,以便他们将调用委托给ContentPane
的相应方法。 例如,您可以将子组件添加到对话框中,如下所示:dialog.add(child);
而孩子将被添加到contentPane。contentPane
永远null
。 尝试将其设置为null
生成异常。 默认的contentPane
有一个BorderLayout
管理器。 请参阅RootPaneContainer
的详细信息,添加,删除和设置LayoutManager
一个的JDialog
。请参阅
JRootPane
文档的完整描述contentPane
,glassPane
,并layeredPane
组件。在多屏幕环境中,您可以在与其所有者不同的屏幕设备上创建一个
JDialog
。 有关详细信息,请参阅Frame
。警告: Swing不是线程安全的。 欲了解更多信息,请参阅Swing's Threading Policy 。
警告:此类的序列化对象与将来的Swing版本不兼容。 当前的序列化支持适用于运行相同版本的Swing的应用程序之间的短期存储或RMI。 从1.4开始,支持所有JavaBeans的长期存储已被添加到
java.beans
包中。 请参阅XMLEncoder
。- 从以下版本开始:
- 1.2
- 另请参见:
-
JOptionPane
,JRootPane
,RootPaneContainer
, Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class 描述 protected class
JDialog.AccessibleJDialog
该类实现JDialog
类的可访问性支持。-
Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
-
Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer
-
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
-
-
Field Summary
Fields Modifier and Type Field 描述 protected AccessibleContext
accessibleContext
AccessibleContext
与此JDialog
相关联protected JRootPane
rootPane
protected boolean
rootPaneCheckingEnabled
如果是,那么拨打add
和setLayout
电话将被转发到contentPane
。-
Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
-
Fields inherited from class java.awt.Dialog
DEFAULT_MODALITY_TYPE
-
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
-
Fields inherited from interface javax.swing.WindowConstants
DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE
-
-
构造方法摘要
构造方法 Constructor 描述 JDialog()
创建一个没有标题的无模式对话框,而不指定Frame
所有者。JDialog(Dialog owner)
使用指定的Dialog
作为其所有者创建无模式对话框,并创建一个空标题。JDialog(Dialog owner, boolean modal)
创建一个具有空标题和指定模式的Dialog
,其中所有者为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
,其中所有者为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
,其中所有者为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 方法 描述 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
毫秒内重新绘制此组件的指定矩形。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.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 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.Dialog
addNotify, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setBackground, setModal, setModalityType, setOpacity, setResizable, setShape, setTitle, setUndecorated, setVisible, show, toBack
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
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
-
-
-
-
字段详细信息
-
rootPane
protected JRootPane rootPane
-
rootPaneCheckingEnabled
protected boolean rootPaneCheckingEnabled
如果为真,那么拨打add
和setLayout
电话将被转发到contentPane
。 这最初是假的,但是当构建JDialog
时设置为true。
-
accessibleContext
protected AccessibleContext accessibleContext
AccessibleContext
与此JDialog
相关联
-
-
构造方法详细信息
-
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
,共享的隐藏帧将被设置为对话框的所有者。此构造函数将组件的locale属性设置为返回的值为
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
,其中所有者为Frame
。 如果owner
是null
,则共享的隐藏帧将被设置为对话框的所有者。该构造函数将组件的locale属性设置为
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
,则共享的隐藏帧将被设置为对话框的所有者。此构造函数将组件的locale属性设置为返回的值为
JComponent.getDefaultLocale
。注意:此构造函数不允许您创建未知的
JDialog
。 要创建一个未知的JDialog
您必须使用JDialog(Window)
或JDialog(Dialog)
构造函数,其参数为null
。- 参数
-
owner
- 显示对话框的Frame
-
title
- 要在对话框的标题栏中显示的String
- 异常
-
HeadlessException
- 如果GraphicsEnvironment.isHeadless()
返回true
。 - 另请参见:
-
GraphicsEnvironment.isHeadless()
,JComponent.getDefaultLocale()
-
JDialog
public JDialog(Frame owner, String title, boolean modal)
创建一个具有指定标题的对话框,所有者Frame
和模态。 如果owner
是null
,则会将共享的隐藏帧设置为此对话框的所有者。此构造函数将组件的locale属性设置为返回的值为
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
,则会将共享的隐藏帧设置为此对话框的所有者。此构造函数将组件的locale属性设置为由
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
作为其所有者创建无模式对话框,并创建一个空标题。该构造函数将组件的locale属性设置为返回的值为
JComponent.getDefaultLocale
。- 参数
-
owner
- 显示对话框的所有者Dialog
或如果此对话框没有所有者,null
- 异常
-
HeadlessException
-if GraphicsEnvironment.isHeadless()
返回true
。 - 另请参见:
-
GraphicsEnvironment.isHeadless()
,JComponent.getDefaultLocale()
-
JDialog
public JDialog(Dialog owner, boolean modal)
创建一个具有空标题和指定模态的Dialog
,其中所有者为Dialog
。此构造函数将组件的locale属性设置为由
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)
使用指定的标题和指定的所有者对话框创建无模式对话框。该构造函数将组件的locale属性设置为返回值
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
。此构造函数将组件的locale属性设置为由
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
模态对话框内创建)将被迫轻量级的。该构造函数将组件的locale属性设置为
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
作为其所有者创建无模式对话框,并创建一个空标题。此构造函数将组件的locale属性设置为返回的值为
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
,其中所有者为Window
。该构造函数将组件的locale属性设置为
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
。此构造函数将组件的locale属性设置为返回的值为
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
和模态。此构造函数将组件的locale属性设置为由
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
模态对话框内创建)将被迫轻量级的。此构造函数将组件的locale属性设置为由
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
。- 结果
-
一个新的
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
):不要做任何事; 要求程序在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
@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
使用时,TransferHandler
仅提供数据导入功能,因为数据导出相关方法当前键入为JComponent
。有关详细信息,请参阅“Java教程”中的“ 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
@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
转发add
和setLayout
的contentPane
。- 结果
-
如果转发
add
和add
,setLayout
true; 否则为假 - 另请参见:
-
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
转发add
和setLayout
的contentPane
。- 参数
-
enabled
- 如果add
和setLayout
被转发,则为true,如果它们应直接在JDialog
上操作,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
的孩子,这将不会执行任何contentPane
。- 重写:
-
remove
在Container
- 参数
-
comp
- 要删除的组件 - 异常
-
NullPointerException
- 如果comp
为空 - 另请参见:
-
Container.add(java.awt.Component)
,RootPaneContainer
-
setLayout
public void setLayout(LayoutManager manager)
- 重写:
-
setLayout
在Container
- 参数
-
manager
-LayoutManager
- 另请参见:
-
setRootPaneCheckingEnabled(boolean)
,RootPaneContainer
-
getRootPane
@BeanProperty(bound=false, hidden=true, description="the RootPane object for this dialog.") 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
@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
。- 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
@BeanProperty(bound=false, hidden=true, description="The pane which holds the various dialog layers.") 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
@BeanProperty(bound=false, hidden=true, description="A transparent pane used for menu rendering.") public void setGlassPane(Component glassPane)
设置glassPane
属性。 该方法由构造函数调用。- Specified by:
-
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
是真的,当前的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
- 结果
- an AccessibleJDialog that serves as the AccessibleContext of this JDialog
-
-