模块 java.desktop

软件包 java.awt

Class Dialog

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Window

java.awt.Dialog

实现的所有接口

ImageObserver ， MenuContainer ， Serializable ， Accessible

已知直接子类：

FileDialog ， JDialog

public class Dialog
extends Window

对话框是一个顶级窗口，带有标题和边框，通常用于从用户那里获取某种形式的输入。 对话框的大小包括为边框指定的任何区域。 边界区域的尺寸可以使用getInsets方法获得，但是，由于这些尺寸与平台相关，因此在通过调用pack或show使对话框可显示之前，无法获得有效的插入值。 由于边框区域包含在对话框的整体大小中，因此边框有效地遮挡了对话框的一部分，将可用于渲染的区域和/或显示子组件限制为具有左上角位置(insets.left, insets.top) ，以及尺寸为width - (insets.left + insets.right) by 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

嵌套类汇总

嵌套类

变量和类型	类	描述
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

嵌套类/接口声明在类 java.awt.Component

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

字段汇总

字段

变量和类型	字段	描述
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

声明方法的类 java.lang.Object

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

字段详细信息

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)

使用指定的所有者 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)

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

此方法已过时，仅用于向后兼容。 请改用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 - 对话框边框中显示的标题; 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

@Deprecated
public void show()

Deprecated.

As of JDK version 1.5, replaced by setVisible(boolean).

使Dialog可见。 如果对话框和/或其所有者尚未显示，则两者都可显示。 该对话框将在变为可见之前进行验证。 如果对话框已经可见，则会将对话框置于最前面。

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

重写：

show类 Window

另请参见：

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

hide

@Deprecated
public void hide()

Deprecated.

As of JDK version 1.5, replaced by setVisible(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