Module java.desktop

Package 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)乘以height - (insets.top + insets.bottom)。

对话框的默认布局是BorderLayout。

对话框可以通过setUndecorated关闭其本机装饰（即框架和标题栏）。这只能在对话框不可显示时完成。

当构造对话框时，可以将另一个窗口作为其所有者。当可见对话框的所有者窗口最小化时，对话框将自动隐藏。当所有者窗口随后恢复时，对话框将再次对用户可见。

在多屏环境中，可以在不同的屏幕设备上创建Dialog。有关更多信息，请参见Frame。

对话框可以是非模态的（默认）或模态的。模态对话框是一种阻止应用程序中某些其他顶层窗口的输入的对话框，除了那些以对话框为所有者创建的窗口。有关详细信息，请参见AWT模态性规范。

对话框能够生成以下WindowEvents： WindowOpened, WindowClosing, WindowClosed, WindowActivated, WindowDeactivated, WindowGainedFocus, WindowLostFocus。

自 JDK 版本:

1.0

另请参阅:

• WindowEvent
• Window.addWindowListener(java.awt.event.WindowListener)
• 序列化形式

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected class	Dialog.AccessibleAWTDialog	该类为Dialog类实现了辅助功能支持。
static enum	Dialog.ModalExclusionType	任何顶层窗口都可以标记为不受模态对话框阻塞。
static enum	Dialog.ModalityType	模态对话框会阻止对某些顶层窗口的所有输入。

Nested classes/interfaces declared in class java.awt.Window

Window.AccessibleAWTWindow, Window.Type

Nested classes/interfaces declared in class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces declared in class java.awt.Component

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

Field Summary

Fields

Modifier and Type	Field	Description
static final Dialog.ModalityType	DEFAULT_MODALITY_TYPE	模态对话框的默认模态类型。

Fields declared in class 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

Constructor Summary

Constructors

Constructor	Description
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、标题、模态性和GraphicsConfiguration构造一个最初不可见的Dialog。
Dialog(Frame owner)	使用指定的所有者Frame和空标题构造一个最初不可见的非模态Dialog。
Dialog(Frame owner, boolean modal)	使用指定的所有者Frame、模态性和空标题构造一个最初不可见的Dialog。
Dialog(Frame owner, String title)	使用指定的所有者Frame和标题构造一个最初不可见的非模态Dialog。
Dialog(Frame owner, String title, boolean modal)	使用指定的所有者Frame、标题和模态性构造一个最初不可见的Dialog。
Dialog(Frame owner, String title, boolean modal, GraphicsConfiguration gc)	使用指定的所有者Frame、标题、模态性和GraphicsConfiguration构造一个最初不可见的Dialog。
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、标题和模态性构造一个最初不可见的Dialog。
Dialog(Window owner, String title, Dialog.ModalityType modalityType, GraphicsConfiguration gc)	使用指定的所有者Window、标题、模态性和GraphicsConfiguration构造一个最初不可见的Dialog。

Method Summary

Modifier and Type	Method	Description
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	setModal(boolean modal)	指定此对话框是否应为模态。
void	setModalityType(Dialog.ModalityType type)	设置此对话框的模态类型。
void	setResizable(boolean resizable)	设置用户是否可以调整此对话框的大小。
void	setTitle(String title)	设置对话框的标题。
void	setUndecorated(boolean undecorated)	禁用或启用此对话框的装饰。
void	setVisible(boolean b)	根据参数b的值显示或隐藏此Dialog。
void	show()	已过时。 自 JDK 版本 1.5 起，已由setVisible(boolean)替换。
void	toBack()	如果此窗口可见，则将此窗口发送到后面，并且如果它是焦点或活动窗口，则可能导致其失去焦点或激活。

Methods declared in 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, 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

Methods declared in 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, removeNotify, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusDownCycle, update, validate, validateTree

Methods declared in 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 declared in class java.lang.Object

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

Field Details

DEFAULT_MODALITY_TYPE

             public static final Dialog.ModalityType DEFAULT_MODALITY_TYPE
            

模态对话框的默认模态类型。默认模态类型为APPLICATION_MODAL。调用旧式的setModal(true)等同于setModalityType(DEFAULT_MODALITY_TYPE)。

自 JDK 版本:

1.6

另请参阅:

• Dialog.ModalityType
• setModal(boolean)

Constructor Details

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)
            

构造具有指定所有者Frame、标题、模态和GraphicsConfiguration的初始不可见Dialog。

参数:

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、标题、模态和GraphicsConfiguration的初始不可见Dialog。

参数:

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)
            

构造具有指定所有者 Window、标题、模态性和 GraphicsConfiguration 的初始不可见的 Dialog。

参数:

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)

Method Details

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)
            

根据参数b的值显示或隐藏此Dialog。

覆盖:

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中显示在任何其他窗口后面。如果此窗口不可见，则不会执行任何操作。某些平台不允许由其他窗口拥有的窗口出现在其所有者下方。将尽一切努力将此窗口尽可能低地放置在堆叠顺序中；但是，开发人员不应假设此方法将在所有情况下将此窗口移动到所有其他窗口下方。

由于本机窗口系统的变化，无法保证对焦点和活动窗口的更改。开发人员绝不能假设此窗口不再是焦点或活动窗口，直到此窗口接收到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)

paramString

             protected String paramString()
            

返回表示此对话框状态的字符串。此方法仅用于调试目的，返回的字符串的内容和格式可能因实现而异。返回的字符串可能为空，但不会是null。

覆盖:

paramString 在类 Container

返回:

此对话框窗口的参数字符串。

getAccessibleContext

             public AccessibleContext getAccessibleContext()
            

获取与此对话框关联的AccessibleContext。对于对话框，AccessibleContext采用AccessibleAWTDialog的形式。如有必要，将创建一个新的AccessibleAWTDialog实例。

指定者:

getAccessibleContext 在接口 Accessible

覆盖:

getAccessibleContext 在类 Window

返回:

作为此对话框的AccessibleContext的AccessibleAWTDialog

自从:

1.3