- java.lang.Object
-
- java.awt.Component
-
- java.awt.Container
-
- java.awt.Window
-
- java.awt.Dialog
-
- All Implemented Interfaces:
-
ImageObserver
,MenuContainer
,Serializable
,Accessible
- 已知直接子类:
-
FileDialog
,JDialog
public class Dialog extends Window
Dialog是一个具有标题和边框的顶级窗口,通常用于从用户处采取某种形式的输入。 对话框的大小包括为边框指定的任何区域。 可以使用getInsets
方法获得边界区域的尺寸,但是由于这些尺寸与平台相关,所以只有通过调用pack
或show
可以显示对话框,才能获得有效的插入值。 由于边界区域被包括在对话框的总体大小中,边界有效地掩盖了对话框的一部分,限制了可用于向左上角位置为(insets.left, insets.top)
的矩形呈现和/或显示子组件的(insets.left, insets.top)
,以及具有width - (insets.left + insets.right)
的height - (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
-
-
Nested Class Summary
Nested Classes Modifier and Type Class 描述 protected class
Dialog.AccessibleAWTDialog
这个类实现Dialog
类的可访问性支持。static class
Dialog.ModalExclusionType
任何顶级窗口都可以标记为不被模态对话框阻止。static class
Dialog.ModalityType
模态对话框阻止某些顶级窗口的所有输入。-
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.Window
Window.AccessibleAWTWindow, Window.Type
-
-
Field Summary
Fields Modifier and Type Field 描述 static Dialog.ModalityType
DEFAULT_MODALITY_TYPE
模态对话框的默认模式类型。-
Fields inherited from class java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
-
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
-
-
构造方法摘要
构造方法 Constructor 描述 Dialog(Dialog owner)
构造一个最初看不见的,无模式的Dialog
与指定的所有者Dialog
和一个空的标题。Dialog(Dialog owner, String title)
构造一个最初看不见的,无指定的Dialog
与指定的所有者Dialog
和标题。Dialog(Dialog owner, String title, boolean modal)
构造一个最初看不见的Dialog
与指定的所有者Dialog
,标题和模态。Dialog(Dialog owner, String title, boolean modal, GraphicsConfiguration gc)
构造一个最初不可见的Dialog
与指定的所有者Dialog
,标题,模式和GraphicsConfiguration
。Dialog(Frame owner)
构造一个初始隐形的,无指定的Dialog
与指定的所有者Frame
和一个空的标题。Dialog(Frame owner, boolean modal)
构造一个最初不可见的Dialog
与指定的所有者Frame
和模态和一个空的标题。Dialog(Frame owner, String title)
构造一个初始隐形的,无指定的Dialog
与指定的所有者Frame
和标题。Dialog(Frame owner, String title, boolean modal)
构造一个最初看不见的Dialog
与指定的所有者Frame
,标题和模态。Dialog(Frame owner, String title, boolean modal, GraphicsConfiguration gc)
构造一个最初看不见的Dialog
与指定的所有者Frame
,标题,模态和GraphicsConfiguration
。Dialog(Window owner)
构造一个初始隐形的,无指定的Dialog
与指定的所有者Window
和一个空的标题。Dialog(Window owner, Dialog.ModalityType modalityType)
构造一个最初看不见的Dialog
与指定的所有者Window
和模态和一个空的标题。Dialog(Window owner, String title)
构造一个最初看不见的,无模式的Dialog
与指定的所有者Window
和标题。Dialog(Window owner, String title, Dialog.ModalityType modalityType)
构造一个最初看不见的Dialog
与指定的所有者Window
,标题和模态。Dialog(Window owner, String title, Dialog.ModalityType modalityType, GraphicsConfiguration gc)
构造最初无形Dialog
与指定的所有者Window
,标题,模式和GraphicsConfiguration
。
-
方法摘要
所有方法 接口方法 具体的方法 弃用的方法 Modifier and Type 方法 描述 void
addNotify()
将此对话框通过将其连接到本机屏幕资源来显示。AccessibleContext
getAccessibleContext()
获取与此对话框关联的AccessibleContext。Dialog.ModalityType
getModalityType()
返回此对话框的模态类型。String
getTitle()
获取对话框的标题。void
hide()
已过时。自JDK版本1.5起,由setVisible(boolean)
替代。boolean
isModal()
指示对话框是否为模态。boolean
isResizable()
指示用户是否可以调整此对话框的大小。boolean
isUndecorated()
指示此对话框是否未装饰。protected String
paramString()
返回表示此对话框状态的字符串。void
setBackground(Color bgColor)
设置此窗口的背景颜色。void
setModal(boolean modal)
指定此对话框是否应该是模态的。void
setModalityType(Dialog.ModalityType type)
设置此对话框的模态类型。void
setOpacity(float opacity)
设置窗口的不透明度。void
setResizable(boolean resizable)
设置用户是否可以调整此对话框的大小。void
setShape(Shape shape)
设置窗口的形状。void
setTitle(String title)
设置对话框的标题。void
setUndecorated(boolean undecorated)
禁用或启用此对话框的装饰。void
setVisible(boolean b)
显示或隐藏此Dialog
取决于参数的值b
。void
show()
已过时。从JDK版本1.5开始,由setVisible(boolean)
替代。void
toBack()
如果此窗口可见,则将此窗口发送到后面,如果该窗口是聚焦窗口或活动窗口,则可能导致其失去焦点或激活。-
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, 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
-
Methods inherited from class 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, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusDownCycle, update, validate, validateTree
-
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, processWindowEvent, 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
-
-
-
-
字段详细信息
-
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)
构造一个初始隐形的,无指定的Dialog
与指定的所有者Frame
和一个空的标题。- 参数
-
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)
构造最初不可见的Dialog
与指定的所有者Frame
和模态和一个空的标题。- 参数
-
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)
构造一个最初看不见的,无模式的Dialog
与指定的所有者Frame
和标题。- 参数
-
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)
构造一个最初看不见的Dialog
与指定的所有者Frame
,标题和模态。- 参数
-
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
具有指定的所有者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
与指定的所有者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)
构造一个最初看不见的,无指定的Dialog
与指定的所有者Window
和一个空的标题。- 参数
-
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)
构造一个初始隐形的,无指定的Dialog
与指定的所有者Window
和标题。- 参数
-
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)
构造最初不可见的Dialog
与指定的所有者Window
和模态和一个空的标题。- 参数
-
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)
构造一个最初不可见的Dialog
与指定的所有者Window
,标题和模态。- 参数
-
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()
,Window.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
- 对话框边框中显示的标题; 空值导致空标题 - 另请参见:
-
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
@Deprecated public void show()
已过时。 从JDK版本1.5开始,由setVisible(boolean)
代替。使Dialog
可见。 如果对话框和/或其所有者尚未显示,则两者都可显示。 该对话框将在被显示之前被验证。 如果对话框已经可见,这将使对话框显示在前面。如果对话框是模态的并且尚未显示,则通过调用隐藏或处理隐藏对话框之前,此调用将不会返回。 允许从事件调度线程显示模态对话框,因为工具箱将确保另一个事件泵运行,而调用此方法的那个被阻止。
-
hide
@Deprecated public void hide()
已过时。 截至JDK 1.5版,由setVisible(boolean)
替代。隐藏对话框,然后如果当前被阻止,则会导致show
返回。- 重写:
-
hide
在Window
- 另请参见:
-
Window.show()
,Window.dispose()
,Window.setVisible(boolean)
-
toBack
public void toBack()
如果此窗口可见,则将此窗口发送到后面,如果该窗口是聚焦窗口或活动窗口,则可能导致其失去焦点或激活。将此窗口放置在堆叠顺序的底部,并将其显示在此VM中的任何其他Windows之后。 这个窗口不可见,不会发生任何动作。 某些平台不允许其他Windows拥有的Windows显示在其所有者的下方。 每次尝试将堆叠顺序中的窗口移动到尽可能低的位置; 然而,开发人员不应该假设这种方法会将Window在所有其他窗口中移动到所有情况。
由于本机窗口系统的变化,不能保证关注和活动的Windows的更改。 开发人员绝对不能假定此窗口不再是聚焦或活动窗口,直到此窗口收到WINDOW_LOST_FOCUS或WINDOW_DEACTIVATED事件为止。 在最上面的窗口是关注窗口的平台上,这种方法可能会导致此窗口失去焦点。 在这种情况下,这个VM中的下一个最高的可调焦窗口将会得到关注。 在堆叠顺序通常不会影响聚焦窗口的平台上,此方法可能会使焦点和活动窗口保持不变。
如果此对话框是模态的,并阻止某些窗口,则所有这些对象都将发送到后端,以将它们保留在阻止对话框之下。
- 重写:
-
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)
-
setOpacity
public void setOpacity(float opacity)
设置窗口的不透明度。不透明度值在[0..1]的范围内。 请注意,设置不透明度级别为0可能会禁用此窗口上的鼠标事件处理。 这是依赖于平台的行为。
为了使不透明度值小于
1.0f
必须满足以下条件:- 底层系统必须支持
TRANSLUCENT
半透明度 - 窗口必须未装饰(见
Frame.setUndecorated(boolean)
和setUndecorated(boolean)
) - 窗口不能处于全屏模式(参见
GraphicsDevice.setFullScreenWindow(Window)
)
如果请求的不透明度值小于
1.0f
,并且不符合上述任何条件,窗口不透明度将不会更改,并且将抛出IllegalComponentStateException
。单个像素的半透明度也可以通过其颜色的α分量(见
Window.setBackground(Color)
)和该窗口的当前形状(参见Window.setShape(Shape)
)来实现。 - 底层系统必须支持
-
setShape
public void setShape(Shape shape)
设置窗口的形状。设置形状会切断窗口的某些部分。 只有属于给定的
Shape
的部件保持可见和可点击。 如果形状参数为null
,则此方法将恢复默认形状,使窗口在大多数平台上呈矩形。必须满足以下条件才能设置非空形状:
- 底层系统必须支持
PERPIXEL_TRANSPARENT
半透明度 - 窗口必须未装饰(参见
Frame.setUndecorated(boolean)
和setUndecorated(boolean)
) - 窗口不能处于全屏模式(参见
GraphicsDevice.setFullScreenWindow(Window)
)
如果请求的形状不是
null
,并且不符合上述任何条件,则此窗口的形状将不会改变,并且将抛出UnsupportedOperationException
或IllegalComponentStateException
。单个像素的半透明度也可以通过其颜色的α分量(见
Window.setBackground(Color)
)和不透明度值(见Window.setOpacity(float)
)来实现。 有关详细信息,请参阅GraphicsDevice.WindowTranslucency
。 - 底层系统必须支持
-
setBackground
public void setBackground(Color bgColor)
设置此窗口的背景颜色。如果窗口系统支持
PERPIXEL_TRANSLUCENT
半透明,给定背景颜色的alpha分量可能会影响此窗口的操作模式:它指示此窗口是否为不透明(alpha等于1.0f
)或每像素半透明(alpha小于1.0f
)。 如果给定的背景颜色是null
,则该窗口被认为是完全不透明的。必须满足以下条件以启用此窗口的每像素透明度模式:
-
PERPIXEL_TRANSLUCENT
半透明度必须由此窗口所在的图形设备支持 - 窗口必须未装饰(参见
Frame.setUndecorated(boolean)
和setUndecorated(boolean)
) - 窗口不能处于全屏模式(参见
GraphicsDevice.setFullScreenWindow(Window)
)
如果所请求的背景颜色的alpha分量小于
1.0f
,并且不满足上述任何条件,则此窗口的背景颜色不会改变,给定背景颜色的alpha分量不会影响操作模式这个窗口,和UnsupportedOperationException
或IllegalComponentStateException
将被抛出。当窗口是每像素半透明时,绘图子系统遵循每个像素的alpha值。 如果使用等于零的alpha颜色成分绘制像素,则它将变得视觉上透明。 如果像素的alpha等于1.0f,则像素完全不透明。 alpha颜色分量的中间值使像素半透明。 在此模式下,窗口的背景绘制为给定背景颜色的alpha值。 如果此方法的参数的alpha值等于
0
,则背景0
根本无法显示。给定像素的半透明度的实际水平也取决于窗口不透明度(见
Window.setOpacity(float)
)以及该窗口的当前形状(见Window.setShape(Shape)
)。请注意,绘制Alpha值为
0
的像素可能会禁用该像素上的鼠标事件处理。 这是依赖于平台的行为。 为了确保鼠标事件不被分派到特定的像素,像素必须从窗口的形状中排除。由于本机平台要求,启用每像素半透明模式可能会改变该窗口的图形配置。
- 重写:
-
setBackground
在Window
- 参数
-
bgColor
- 成为此窗口的背景颜色的颜色。 - 另请参见:
-
Window.getBackground()
,Window.isOpaque()
,Window.setOpacity(float)
,Window.setShape(Shape)
,Frame.isUndecorated()
,isUndecorated()
,GraphicsDevice.WindowTranslucency
,GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)
,GraphicsConfiguration.isTranslucencyCapable()
-
-
paramString
protected String paramString()
返回表示此对话框状态的字符串。 该方法仅用于调试目的,并且返回的字符串的内容和格式可能因实现而异。 返回的字符串可能为空,但可能不是null
。- 重写:
-
paramString
在Container
- 结果
- 该对话窗口的参数字符串。
-
getAccessibleContext
public AccessibleContext getAccessibleContext()
获取与此对话框关联的AccessibleContext。 对于对话框,AccessibleContext采用AccessibleAWTDialog的形式。 如有必要,将创建一个新的AccessibleAWTDialog实例。- Specified by:
-
getAccessibleContext
在接口Accessible
- 重写:
-
getAccessibleContext
在Window
- 结果
- 一个AccessibleAWTDialog,作为此对话框的AccessibleContext
- 从以下版本开始:
- 1.3
-
-