- java.lang.Object
-
- java.awt.Component
-
- java.awt.Container
-
- java.awt.Window
-
- java.awt.Dialog
-
- 实现的所有接口
-
ImageObserver
,MenuContainer
,Serializable
,Accessible
- 已知直接子类:
-
FileDialog
,JDialog
public class Dialogextends Window
对话框是一个顶级窗口,带有标题和边框,通常用于从用户那里获取某种形式的输入。 对话框的大小包括为边框指定的任何区域。 边界区域的尺寸可以使用getInsets
方法获得,但是,由于这些尺寸与平台相关,因此在通过调用pack
或show
使对话框可显示之前,无法获得有效的插入值。 由于边框区域包含在对话框的整体大小中,因此边框有效地遮挡了对话框的一部分,将可用于渲染的区域和/或显示子组件限制为具有左上角位置(insets.left, insets.top)
,以及尺寸为width - (insets.left + insets.right)
byheight - (insets.top + insets.bottom)
。对话框的默认布局是
BorderLayout
。对话框可以使用
setUndecorated
关闭其原生装饰(即Frame&Titlebar)。 这只能在对话框不是displayable
时完成 。对话框在构造时可能有另一个窗口作为其所有者。 当可视对话框的所有者窗口最小化时,对话框将自动对用户隐藏。 随后恢复所有者窗口时,再次使用户可以看到该对话框。
在多屏幕环境中,您可以在与其所有者不同的屏幕设备上创建
Dialog
。 有关更多信息,请参见Frame
。对话框可以是无模式(默认)或模态。 模式对话框是阻止对应用程序中某些其他顶级窗口的输入的对话框,除了以对话框作为其所有者创建的任何窗口。 有关详细信息,请参阅AWT Modality规范。
对话框是能够产生以下的
WindowEvents
:WindowOpened
,WindowClosing
,WindowClosed
,WindowActivated
,WindowDeactivated
,WindowGainedFocus
,WindowLostFocus
。- 从以下版本开始:
- 1.0
- 另请参见:
-
WindowEvent
,Window.addWindowListener(java.awt.event.WindowListener)
, Serialized Form
-
-
嵌套类汇总
嵌套类 变量和类型 类 描述 protected class
Dialog.AccessibleAWTDialog
此类实现Dialog
类的可访问性支持。static class
Dialog.ModalExclusionType
可以通过模态对话框标记任何顶级窗口不被阻止。static class
Dialog.ModalityType
模态对话框会阻止某些顶级窗口的所有输入。-
嵌套类/接口声明在类 java.awt.Window
Window.AccessibleAWTWindow, Window.Type
-
嵌套类/接口声明在类 java.awt.Container
Container.AccessibleAWTContainer
-
-
字段汇总
字段 变量和类型 字段 描述 static Dialog.ModalityType
DEFAULT_MODALITY_TYPE
模态对话框的默认模态类型。-
声明的属性在类 java.awt.Component
accessibleContext, 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
-
-
构造方法摘要
构造方法 构造器 描述 Dialog(Dialog owner)
使用指定的所有者Dialog
和一个空标题构造一个最初不可见的无模式Dialog
。Dialog(Dialog owner, String title)
使用指定的所有者Dialog
和title构造一个最初不可见的无模式Dialog
。Dialog(Dialog owner, String title, boolean modal)
使用指定的所有者Dialog
,title和modality构造一个最初不可见的Dialog
。Dialog(Dialog owner, String title, boolean modal, GraphicsConfiguration gc)
构造一个最初不可见的Dialog
带有指定的所有者Dialog
,标题,模式和GraphicsConfiguration
。Dialog(Frame owner)
使用指定的所有者Frame
和一个空标题构造一个最初不可见的无模式Dialog
。Dialog(Frame owner, boolean modal)
使用指定的所有者Frame
和模态以及空标题构造一个最初不可见的Dialog
。Dialog(Frame owner, String title)
使用指定的所有者Frame
和title构造一个最初不可见的无模式Dialog
。Dialog(Frame owner, String title, boolean modal)
使用指定的所有者Frame
,标题和模态构造一个最初不可见的Dialog
。Dialog(Frame owner, String title, boolean modal, GraphicsConfiguration gc)
构造一个最初不可见的Dialog
带有指定的所有者Frame
,标题,模式和GraphicsConfiguration
。Dialog(Window owner)
使用指定的所有者Window
和一个空标题构造一个最初不可见的无模式Dialog
。Dialog(Window owner, Dialog.ModalityType modalityType)
使用指定的所有者Window
和模态以及空标题构造一个最初不可见的Dialog
。Dialog(Window owner, String title)
使用指定的所有者Window
和标题构造一个最初不可见的无模式Dialog
。Dialog(Window owner, String title, Dialog.ModalityType modalityType)
使用指定的所有者Window
,title和modality构造一个最初不可见的Dialog
。Dialog(Window owner, String title, Dialog.ModalityType modalityType, GraphicsConfiguration gc)
构造一个最初不可见的Dialog
带有指定的所有者Window
,标题,模式和GraphicsConfiguration
。
-
方法摘要
所有方法 实例方法 具体的方法 弃用的方法 变量和类型 方法 描述 void
addNotify()
通过将此对话框连接到本机屏幕资源,可以显示此对话框。AccessibleContext
getAccessibleContext()
获取与此Dialog关联的AccessibleContext。Dialog.ModalityType
getModalityType()
返回此对话框的模态类型。String
getTitle()
获取对话框的标题。void
hide()
已过时。截至JDK 1.5版,由setVisible(boolean)
取代。boolean
isModal()
指示对话框是否为模态。boolean
isResizable()
指示用户是否可以调整此对话框的大小。boolean
isUndecorated()
指示此对话框是否未修饰。protected String
paramString()
返回表示此对话框状态的字符串。void
setModal(boolean modal)
指定此对话框是否应为模态。void
setModalityType(Dialog.ModalityType type)
设置此对话框的模态类型。void
setResizable(boolean resizable)
设置此对话框是否可由用户调整大小。void
setTitle(String title)
设置对话框的标题。void
setUndecorated(boolean undecorated)
禁用或启用此对话框的装饰。void
setVisible(boolean b)
显示或隐藏此Dialog
具体取决于参数b
的值。void
show()
已过时。截至JDK 1.5版,由setVisible(boolean)
取代。void
toBack()
如果此窗口可见,则将此窗口发送到后面,如果它是聚焦或活动窗口,则可能导致它失去焦点或激活。-
声明方法的类 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, processWindowEvent, 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
-
声明方法的类 java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, 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, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusDownCycle, update, 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, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, 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, 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
-
-
-
-
字段详细信息
-
DEFAULT_MODALITY_TYPE
public static final Dialog.ModalityType DEFAULT_MODALITY_TYPE
模态对话框的默认模态类型。 默认模态类型为APPLICATION_MODAL
。 调用oldstylesetModal(true)
等于setModalityType(DEFAULT_MODALITY_TYPE)
。- 从以下版本开始:
- 1.6
- 另请参见:
-
Dialog.ModalityType
,setModal(boolean)
-
-
构造方法详细信息
-
Dialog
public Dialog(Frame owner)
使用指定的所有者Frame
和一个空标题构造一个最初不可见的无模式Dialog
。- 参数
-
owner
- 对话框的所有者或null
如果此对话框没有所有者) - 异常
-
IllegalArgumentException
- 如果owner
的GraphicsConfiguration
不是来自屏幕设备 -
HeadlessException
- 当GraphicsEnvironment.isHeadless()
返回true
- 另请参见:
-
GraphicsEnvironment.isHeadless()
,Component.setSize(int, int)
,Component.setVisible(boolean)
-
Dialog
public Dialog(Frame owner, boolean modal)
使用指定的所有者Frame
和模态以及空标题构造一个最初不可见的Dialog
。- 参数
-
owner
- 对话框的所有者或null
如果此对话框没有所有者) -
modal
- 指定对话框是否在显示时阻止用户输入到其他顶级窗口。 如果是false
,则对话框为MODELESS
; 如果为true
,则模态类型属性设置为DEFAULT_MODALITY_TYPE
- 异常
-
IllegalArgumentException
- 如果owner
的GraphicsConfiguration
不是来自屏幕设备 -
HeadlessException
- 当GraphicsEnvironment.isHeadless()
返回true
- 另请参见:
-
Dialog.ModalityType
,Dialog.ModalityType.MODELESS
,DEFAULT_MODALITY_TYPE
,setModal(boolean)
,setModalityType(java.awt.Dialog.ModalityType)
,GraphicsEnvironment.isHeadless()
-
Dialog
public Dialog(Frame owner, String title)
使用指定的所有者Frame
和标题构造一个最初不可见的无模式Dialog
。- 参数
-
owner
- 对话框的所有者或null
如果此对话框没有所有者) -
title
- 对话框的标题,如果此对话框没有标题,null
- 异常
-
IllegalArgumentException
- 如果owner
的GraphicsConfiguration
不是来自屏幕设备 -
HeadlessException
- 当GraphicsEnvironment.isHeadless()
返回true
- 另请参见:
-
GraphicsEnvironment.isHeadless()
,Component.setSize(int, int)
,Component.setVisible(boolean)
-
Dialog
public Dialog(Frame owner, String title, boolean modal)
使用指定的所有者Frame
,标题和模态构造一个最初不可见的Dialog
。- 参数
-
owner
- 对话框的所有者或null
如果此对话框没有所有者) -
title
- 对话框的标题或null
如果此对话框没有标题) -
modal
- 指定对话框是否在显示时阻止用户输入到其他顶级窗口。 如果是false
,则对话框为MODELESS
; 如果为true
,则模态类型属性设置为DEFAULT_MODALITY_TYPE
- 异常
-
IllegalArgumentException
- 如果owner
的GraphicsConfiguration
不是来自屏幕设备 -
HeadlessException
- 当GraphicsEnvironment.isHeadless()
返回true
- 另请参见:
-
Dialog.ModalityType
,Dialog.ModalityType.MODELESS
,DEFAULT_MODALITY_TYPE
,setModal(boolean)
,setModalityType(java.awt.Dialog.ModalityType)
,GraphicsEnvironment.isHeadless()
,Component.setSize(int, int)
,Component.setVisible(boolean)
-
Dialog
public Dialog(Frame owner, String title, boolean modal, GraphicsConfiguration gc)
构造一个最初不可见的Dialog
带有指定的所有者Frame
,标题,模式和GraphicsConfiguration
。- 参数
-
owner
- 对话框的所有者或null
如果此对话框没有所有者) -
title
- 对话框的标题或null
如果此对话框没有标题) -
modal
- 指定对话框是否在显示时阻止用户输入到其他顶级窗口。 如果是false
,则对话框为MODELESS
; 如果为true
,则模态类型属性设置为DEFAULT_MODALITY_TYPE
-
gc
- 目标屏幕设备的GraphicsConfiguration
; 如果是null
,则假定为默认系统GraphicsConfiguration
- 异常
-
IllegalArgumentException
- 如果gc
不是来自屏幕设备 -
HeadlessException
- 当GraphicsEnvironment.isHeadless()
返回true
- 从以下版本开始:
- 1.4
- 另请参见:
-
Dialog.ModalityType
,Dialog.ModalityType.MODELESS
,DEFAULT_MODALITY_TYPE
,setModal(boolean)
,setModalityType(java.awt.Dialog.ModalityType)
,GraphicsEnvironment.isHeadless()
,Component.setSize(int, int)
,Component.setVisible(boolean)
-
Dialog
public Dialog(Dialog owner)
使用指定的所有者Dialog
和一个空标题构造一个最初不可见的无模式Dialog
。- 参数
-
owner
- 对话框的所有者或null
如果此对话框没有所有者) - 异常
-
IllegalArgumentException
- 如果owner
的GraphicsConfiguration
不是来自屏幕设备 -
HeadlessException
- 当GraphicsEnvironment.isHeadless()
返回true
- 从以下版本开始:
- 1.2
- 另请参见:
-
GraphicsEnvironment.isHeadless()
-
Dialog
public Dialog(Dialog owner, String title)
使用指定的所有者Dialog
和title构造一个最初不可见的无模式Dialog
。- 参数
-
owner
- 对话框的所有者或null
如果没有所有者) -
title
- 对话框的标题,如果此对话框没有标题,null
- 异常
-
IllegalArgumentException
- 如果owner
的GraphicsConfiguration
不是来自屏幕设备 -
HeadlessException
- 当GraphicsEnvironment.isHeadless()
返回true
- 从以下版本开始:
- 1.2
- 另请参见:
-
GraphicsEnvironment.isHeadless()
-
Dialog
public Dialog(Dialog owner, String title, boolean modal)
使用指定的所有者Dialog
,title和modality构造一个最初不可见的Dialog
。- 参数
-
owner
- 对话框的所有者或null
如果此对话框没有所有者) -
title
- 对话框的标题,如果此对话框没有标题,null
-
modal
- 指定对话框是否在显示时阻止用户输入到其他顶级窗口。 如果是false
,则对话框为MODELESS
; 如果为true
,则模态类型属性设置为DEFAULT_MODALITY_TYPE
- 异常
-
IllegalArgumentException
- 如果owner
的GraphicsConfiguration
不是来自屏幕设备 -
HeadlessException
- 当GraphicsEnvironment.isHeadless()
返回true
- 从以下版本开始:
- 1.2
- 另请参见:
-
Dialog.ModalityType
,Dialog.ModalityType.MODELESS
,DEFAULT_MODALITY_TYPE
,setModal(boolean)
,setModalityType(java.awt.Dialog.ModalityType)
,GraphicsEnvironment.isHeadless()
-
Dialog
public Dialog(Dialog owner, String title, boolean modal, GraphicsConfiguration gc)
构造一个最初不可见的Dialog
带有指定的所有者Dialog
,标题,模式和GraphicsConfiguration
。- 参数
-
owner
- 对话框的所有者或null
如果此对话框没有所有者) -
title
- 对话框的标题,如果此对话框没有标题,null
-
modal
- 指定对话框是否在显示时阻止用户输入到其他顶级窗口。 如果是false
,则对话框为MODELESS
; 如果为true
,则模态类型属性设置为DEFAULT_MODALITY_TYPE
-
gc
- 目标屏幕设备的GraphicsConfiguration
; 如果为null
,则假定为默认系统GraphicsConfiguration
- 异常
-
IllegalArgumentException
- 如果gc
不是来自屏幕设备 -
HeadlessException
- 当GraphicsEnvironment.isHeadless()
返回true
- 从以下版本开始:
- 1.4
- 另请参见:
-
Dialog.ModalityType
,Dialog.ModalityType.MODELESS
,DEFAULT_MODALITY_TYPE
,setModal(boolean)
,setModalityType(java.awt.Dialog.ModalityType)
,GraphicsEnvironment.isHeadless()
,Component.setSize(int, int)
,Component.setVisible(boolean)
-
Dialog
public Dialog(Window owner)
使用指定的所有者Window
和一个空标题构造一个最初不可见的无模式Dialog
。- 参数
-
owner
- 对话框的所有者。 所有者必须是一个实例Dialog
,Frame
,任何他们的后代或null
- 异常
-
IllegalArgumentException
- 如果owner
不是Dialog
或Frame
的实例 -
IllegalArgumentException
- 如果owner
的GraphicsConfiguration
不是来自屏幕设备 -
HeadlessException
- 当GraphicsEnvironment.isHeadless()
返回true
- 从以下版本开始:
- 1.6
- 另请参见:
-
GraphicsEnvironment.isHeadless()
-
Dialog
public Dialog(Window owner, String title)
使用指定的所有者Window
和标题构造一个最初不可见的无模式Dialog
。- 参数
-
owner
- 对话框的所有者。 所有者必须是一个实例Dialog
,Frame
,任何他们的后代或null
-
title
- 对话框的标题,如果此对话框没有标题,null
- 异常
-
IllegalArgumentException
-如果owner
不是一个实例Dialog
或Frame
-
IllegalArgumentException
- 如果owner
的GraphicsConfiguration
不是来自屏幕设备 -
HeadlessException
- 当GraphicsEnvironment.isHeadless()
返回true
- 从以下版本开始:
- 1.6
- 另请参见:
-
GraphicsEnvironment.isHeadless()
-
Dialog
public Dialog(Window owner, Dialog.ModalityType modalityType)
使用指定的所有者Window
和模态以及空标题构造一个最初不可见的Dialog
。- 参数
-
owner
- 对话框的所有者。 所有者必须是一个实例Dialog
,Frame
,任何他们的后代或null
-
modalityType
- 指定对话框是否在显示时阻止输入到其他窗口。null
值和不支持的模态类型等效于MODELESS
- 异常
-
IllegalArgumentException
-如果owner
不是一个实例Dialog
或Frame
-
IllegalArgumentException
- 如果owner
的GraphicsConfiguration
不是来自屏幕设备 -
HeadlessException
- 当GraphicsEnvironment.isHeadless()
返回true
-
SecurityException
- 如果调用线程无权使用给定的modalityType
创建模式对话框 - 从以下版本开始:
- 1.6
- 另请参见:
-
Dialog.ModalityType
,setModal(boolean)
,setModalityType(java.awt.Dialog.ModalityType)
,GraphicsEnvironment.isHeadless()
,Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)
-
Dialog
public Dialog(Window owner, String title, Dialog.ModalityType modalityType)
使用指定的所有者Window
,标题和模态构造一个最初不可见的Dialog
。- 参数
-
owner
- 对话框的所有者。 所有者必须是一个实例Dialog
,Frame
,任何他们的后代或null
-
title
- 对话框的标题,如果此对话框没有标题,null
-
modalityType
- 指定对话框是否在显示时阻止输入到其他窗口。null
值和不支持的模态类型等效于MODELESS
- 异常
-
IllegalArgumentException
-如果owner
不是一个实例Dialog
或Frame
-
IllegalArgumentException
- 如果owner
的GraphicsConfiguration
不是来自屏幕设备 -
HeadlessException
- 当GraphicsEnvironment.isHeadless()
返回true
-
SecurityException
- 如果调用线程无权使用给定的modalityType
创建模式对话框 - 从以下版本开始:
- 1.6
- 另请参见:
-
Dialog.ModalityType
,setModal(boolean)
,setModalityType(java.awt.Dialog.ModalityType)
,GraphicsEnvironment.isHeadless()
,Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)
-
Dialog
public Dialog(Window owner, String title, Dialog.ModalityType modalityType, GraphicsConfiguration gc)
构造一个最初不可见的Dialog
带有指定的所有者Window
,标题,模式和GraphicsConfiguration
。- 参数
-
owner
- 对话框的所有者。 所有者必须是一个实例Dialog
,Frame
,任何他们的后代或null
-
title
- 对话框的标题,如果此对话框没有标题,null
-
modalityType
- 指定对话框是否在显示时阻止输入到其他窗口。null
值和不支持的模态类型等效于MODELESS
-
gc
- 目标屏幕设备的GraphicsConfiguration
; 如果为null
,则假定为默认系统GraphicsConfiguration
- 异常
-
IllegalArgumentException
- 如果owner
不是Dialog
或Frame
的实例 -
IllegalArgumentException
- 如果gc
不是来自屏幕设备 -
HeadlessException
- 当GraphicsEnvironment.isHeadless()
返回true
-
SecurityException
- 如果调用线程无权使用给定的modalityType
创建模式对话框 - 从以下版本开始:
- 1.6
- 另请参见:
-
Dialog.ModalityType
,setModal(boolean)
,setModalityType(java.awt.Dialog.ModalityType)
,GraphicsEnvironment.isHeadless()
,Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)
-
-
方法详细信息
-
addNotify
public void addNotify()
通过将此对话框连接到本机屏幕资源,可以显示此对话框。 使对话框可显示将使其任何子对象可显示。 此方法由工具包在内部调用,不应由程序直接调用。- 重写:
-
addNotify
类Window
- 另请参见:
-
Component.isDisplayable()
,Container.removeNotify()
-
isModal
public boolean isModal()
指示对话框是否为模态。此方法已过时,仅用于向后兼容。 请改用
getModalityType()
。- 结果
-
true
如果此对话窗口是模态的; 否则为false
- 另请参见:
-
DEFAULT_MODALITY_TYPE
,Dialog.ModalityType.MODELESS
,setModal(boolean)
,getModalityType()
,setModalityType(java.awt.Dialog.ModalityType)
-
setModal
public void setModal(boolean modal)
- 参数
-
modal
- 指定对话框是否在显示时阻止输入到其他窗口; 致电setModal(true)
相当于setModalityType(Dialog.DEFAULT_MODALITY_TYPE)
,致电setModal(false)
相当于setModalityType(Dialog.ModalityType.MODELESS)
- 从以下版本开始:
- 1.1
- 另请参见:
-
DEFAULT_MODALITY_TYPE
,Dialog.ModalityType.MODELESS
,isModal()
,getModalityType()
,setModalityType(java.awt.Dialog.ModalityType)
-
getModalityType
public Dialog.ModalityType getModalityType()
返回此对话框的模态类型。- 结果
- 此对话框的模态类型
- 从以下版本开始:
- 1.6
- 另请参见:
-
setModalityType(java.awt.Dialog.ModalityType)
-
setModalityType
public void setModalityType(Dialog.ModalityType type)
设置此对话框的模态类型。 有关可能的模态类型,请参见ModalityType
。如果不支持给定的模态类型,则使用
MODELESS
。 您可能需要在调用此方法后调用getModalityType()
以确保已设置模态类型。注意:更改可见对话框的模态可能无效,直到它被隐藏然后再次显示。
- 参数
-
type
- 指定对话框是否在显示时阻止输入到其他窗口。null
值和不支持的模态类型等效于MODELESS
- 异常
-
SecurityException
- 如果调用线程无权使用给定的modalityType
创建模式对话框 - 从以下版本开始:
- 1.6
- 另请参见:
-
getModalityType()
,Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)
-
getTitle
public String getTitle()
获取对话框的标题。 标题显示在对话框的边框中。- 结果
- 此对话窗口的标题。 标题可能是
null
。 - 另请参见:
-
setTitle(java.lang.String)
-
setTitle
public void setTitle(String title)
设置对话框的标题。- 参数
-
title
- 对话框边框中显示的标题; null值导致空标题 - 另请参见:
-
getTitle()
-
setVisible
public void setVisible(boolean b)
显示或隐藏此Dialog
具体取决于参数b
的值。- 重写:
-
setVisible
在课程Window
- 参数
-
b
- 如果是true
,则使Dialog
可见,否则隐藏Dialog
。 如果对话框和/或其所有者尚未显示,则两者都可显示。 该对话框将在变为可见之前进行验证。 如果是false
,则隐藏Dialog
,然后在当前被阻止时导致setVisible(true)
返回。模态对话框的注释 。
-
setVisible(true)
:如果对话框尚未显示,则在通过调用setVisible(false)
或dispose
隐藏对话框之前,此调用将不会返回。 -
setVisible(false)
:隐藏对话框,如果当前被阻止,则返回setVisible(true)
。 - 可以从事件调度线程调用此方法,因为该工具包可确保在阻止此方法时不阻止其他事件。
-
- 另请参见:
-
Window.setVisible(boolean)
,Window.dispose()
,Component.isDisplayable()
,Component.validate()
,isModal()
-
show
@Deprecatedpublic void show()
Deprecated.As of JDK version 1.5, replaced bysetVisible(boolean)
.使Dialog
可见。 如果对话框和/或其所有者尚未显示,则两者都可显示。 该对话框将在变为可见之前进行验证。 如果对话框已经可见,则会将对话框置于最前面。如果对话框是模态的并且尚未显示,则在通过调用hide或dispose隐藏对话框之前,此调用将不会返回。 允许从事件调度线程显示模态对话框,因为工具箱将确保在调用此方法的事件被阻止时运行另一个事件泵。
-
hide
@Deprecatedpublic void hide()
Deprecated.As of JDK version 1.5, replaced bysetVisible(boolean)
.隐藏对话框然后导致show
如果当前被阻止则返回。- 重写:
-
hide
在类Window
- 另请参见:
-
Window.show()
,Window.dispose()
,Window.setVisible(boolean)
-
toBack
public void toBack()
如果此窗口可见,则将此窗口发送到后面,如果它是聚焦或活动窗口,则可能导致它失去焦点或激活。将此窗口置于堆叠顺序的底部,并将其显示在此VM中的任何其他Windows后面。 如果此窗口不可见,则不会执行任何操作。 某些平台不允许其他Windows拥有的Windows显示在其所有者下方。 将尽一切努力在堆叠顺序中尽可能低地移动此窗口; 但是,开发人员不应该假设此方法会在所有情况下将此窗口移动到所有其他窗口之下。
由于本机窗口系统的变化,无法保证对焦点和活动Windows的更改。 在此窗口收到WINDOW_LOST_FOCUS或WINDOW_DEACTIVATED事件之前,开发人员绝不能假定此窗口不再是焦点窗口或活动窗口。 在最顶层窗口是焦点窗口的平台上,此方法可能会导致此窗口失去焦点。 在这种情况下,此VM中下一个最高的可聚焦窗口将获得焦点。 在堆叠顺序通常不会影响聚焦窗口的平台上,此方法可能会使焦点和活动Windows保持不变。
如果此对话框是模态的并阻止某些窗口,则所有窗口也会被发送到后面以使它们保持在阻塞对话框下方。
- 重写:
-
toBack
在类Window
- 另请参见:
-
Window.toBack()
-
isResizable
public boolean isResizable()
指示用户是否可以调整此对话框的大小。 默认情况下,所有对话框最初都可以调整大小。- 结果
-
true
如果用户可以调整对话框的大小; 否则为false
。 - 另请参见:
-
setResizable(boolean)
-
setResizable
public void setResizable(boolean resizable)
设置此对话框是否可由用户调整大小。- 参数
-
resizable
-true
如果用户可以调整此对话框的大小; 否则为false
。 - 另请参见:
-
isResizable()
-
setUndecorated
public void setUndecorated(boolean undecorated)
禁用或启用此对话框的装饰。只有在对话框不可显示时才能调用此方法。 要使此对话框装饰,它必须是不透明的并具有默认形状,否则将抛出
IllegalComponentStateException
。 请参阅Window.setShape(java.awt.Shape)
,Window.setOpacity(float)
和Window.setBackground(java.awt.Color)
详细内容- 参数
-
undecorated
-true
如果没有启用对话框装饰;false
如果要启用对话框装饰 - 异常
-
IllegalComponentStateException
- 如果对话框可显示 -
IllegalComponentStateException
- 如果undecorated
是false
,并且此对话框没有默认形状 -
IllegalComponentStateException
- 如果undecorated
是false
,并且此对话框的不透明度小于1.0f
-
IllegalComponentStateException
- 如果undecorated
是false
,并且此对话框的alpha值背景颜色小于1.0f
- 从以下版本开始:
- 1.4
- 另请参见:
-
isUndecorated()
,Component.isDisplayable()
,Window.getShape()
,Window.getOpacity()
,Window.getBackground()
-
isUndecorated
public boolean isUndecorated()
指示此对话框是否未修饰。 默认情况下,所有对话框都是最初修饰的。- 结果
-
true
如果对话框未修饰; 否则为false
。 - 从以下版本开始:
- 1.4
- 另请参见:
-
setUndecorated(boolean)
-
paramString
protected String paramString()
返回表示此对话框状态的字符串。 此方法仅用于调试目的,返回字符串的内容和格式可能因实现而异。 返回的字符串可能为空,但可能不是null
。- 重写:
-
paramString
在类Container
- 结果
- 此对话框窗口的参数字符串。
-
getAccessibleContext
public AccessibleContext getAccessibleContext()
获取与此Dialog关联的AccessibleContext。 对于对话框,AccessibleContext采用AccessibleAWTDialog的形式。 如有必要,将创建一个新的AccessibleAWTDialog实例。- Specified by:
-
getAccessibleContext
接口Accessible
- 重写:
-
getAccessibleContext
,类Window
- 结果
- 一个AccessibleAWTDialog,用作此Dialog的AccessibleContext
- 从以下版本开始:
- 1.3
-
-