Module java.desktop

软件包 java.awt

Class Dialog

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 。 调用oldstyle setModal(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)

指定此对话框是否应该是模态的。

此方法已过时，仅用于向后兼容。 改用setModalityType() 。

注意：可见对话框的更改模式可能没有任何效果，直到它被隐藏，然后再次显示。

参数

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可见。 如果对话框和/或其所有者尚未显示，则两者都可显示。 该对话框将在被显示之前被验证。 如果对话框已经可见，这将使对话框显示在前面。

如果对话框是模态的并且尚未显示，则通过调用隐藏或处理隐藏对话框之前，此调用将不会返回。 允许从事件调度线程显示模态对话框，因为工具箱将确保另一个事件泵运行，而调用此方法的那个被阻止。

重写：

show在 Window

另请参见：

Component.hide() ， Component.isDisplayable() ， Component.validate() ， isModal() ， Window.setVisible(boolean)

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) ）来实现。

重写：

setOpacity Window

参数

opacity - 设置为窗口的不透明度级别

另请参见：

Window.getOpacity() ， Window.setBackground(Color) ， Window.setShape(Shape) ， Frame.isUndecorated() ， isUndecorated() ， GraphicsDevice.WindowTranslucency ， GraphicsDevice.isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency)

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 。

重写：

setShape在 Window

参数

shape - 设置窗口的形状

另请参见：

Window.getShape() ， Window.setBackground(Color) ， Window.setOpacity(float) ， Frame.isUndecorated() ， isUndecorated() ， GraphicsDevice.WindowTranslucency ， GraphicsDevice.isWindowTranslucencySupported(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