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

对话框是一个带有标题和边框的顶层窗口，通常用于从用户输入某种形式的输入。该对话框的大小包括指定的边界的任何区域。边界区域的尺寸可以获得使用 getInsets方法，然而，由于这些尺寸是依赖于平台的，直到对话框被调用 pack或 show得到了显示的是一个有效的插入值不能。由于边境地区是包括在对话框的整体尺寸，边界有效地掩盖了对话的一部分，制约可渲染和/或矩形的左上角位置的 (insets.left, insets.top)显示组件的面积，并通过 height - (insets.top + insets.bottom)大小 width - (insets.left + insets.right)。

一个对话框的默认布局BorderLayout。

一个对话框可能有其天然的装饰（即框架和标题栏）关掉setUndecorated。这只能通过对话框而不是displayable。

当它的所有者的时候，一个对话框可能有另一个窗口作为它的所有者。当一个可见的对话框的所有者窗口最小化时，对话框将自动被隐藏的用户。当所有者窗口随后恢复时，对话框将再次向用户显示。

在多屏幕环境，你可以创造出比它的主人不同的屏幕设备Dialog。更多信息见Frame。

一个对话框可以是非模式（默认）或模态。一个模式对话框是一个块输入到其他一些顶级的窗口在应用程序中，除了任何创建的窗口与对话框作为他们的主人。详情见AWT Modality规范。

对话框可以产生以下WindowEvents：WindowOpened，WindowClosing，WindowClosed，WindowActivated，WindowDeactivated，WindowGainedFocus，WindowLostFocus。

从以下版本开始：

JDK1.0

另请参见：

WindowEvent， Window.addWindowListener(java.awt.event.WindowListener)， Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	Dialog.AccessibleAWTDialog 这个类实现了对 Dialog类可访问性支持。
static class	Dialog.ModalExclusionType 任何顶层窗口可以标记不被模态对话框受阻。
static class	Dialog.ModalityType 模态对话框阻止所有输入一些顶级窗口。

Nested classes/interfaces inherited from class java.awt.Window

Window.AccessibleAWTWindow, Window.Type

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

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

Field Summary

Fields

Modifier and Type	Field and Description
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 and 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与指定的所有者 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	Method and 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	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.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

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.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, getPeer, 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, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_MODALITY_TYPE

public static final Dialog.ModalityType DEFAULT_MODALITY_TYPE

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

从以下版本开始：

一点六

另请参见：

Dialog.ModalityType， setModal(boolean)

Constructor Detail

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

从以下版本开始：

一点四

另请参见：

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

从以下版本开始：

一点二

另请参见：

GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Dialog owner,
              String title)

构建了一个初步的看不见的，非模态 Dialog与指定的所有者 Dialog和标题。

参数

owner -对话框或 null业主如果没有主人

title -对话框或 null标题如果这个对话框没有标题

异常

IllegalArgumentException -如果 owner的 GraphicsConfiguration不是从一个屏幕的设备

HeadlessException当 GraphicsEnvironment.isHeadless()返回 true

从以下版本开始：

一点二

另请参见：

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

从以下版本开始：

一点二

另请参见：

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

从以下版本开始：

一点四

另请参见：

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

从以下版本开始：

一点六

另请参见：

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

从以下版本开始：

一点六

另请参见：

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模态对话框

从以下版本开始：

一点六

另请参见：

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模态对话框

从以下版本开始：

一点六

另请参见：

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模态对话框

从以下版本开始：

一点六

另请参见：

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 -指定对话框块输入其他Windows显示时；打电话 setModal(true)相当于 setModalityType(Dialog.DEFAULT_MODALITY_TYPE)，把 setModal(false)是等效于 setModalityType(Dialog.ModalityType.MODELESS)

从以下版本开始：

一点一

另请参见：

DEFAULT_MODALITY_TYPE， Dialog.ModalityType.MODELESS， isModal()， getModalityType()， setModalityType(java.awt.Dialog.ModalityType)

getModalityType

public Dialog.ModalityType getModalityType()

返回此对话框的模态类型。

结果

此对话框的模式类型

从以下版本开始：

一点六

另请参见：

setModalityType(java.awt.Dialog.ModalityType)

setModalityType

public void setModalityType(Dialog.ModalityType type)

设置此对话框的模式类型。看到 ModalityType可能情态类型。

如果给定的情态类型不支持，MODELESS使用。你可能要调用此方法，以确保情态类型已设置呼叫后getModalityType()。

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

参数

type -指定对话框输入到其他窗口时，显示块。 null价值和不支持的情态类型相当于 MODELESS

异常

SecurityException -如果调用线程没有权限创建与给定的 modalityType模态对话框

从以下版本开始：

一点六

另请参见：

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()

如果这个窗口是可见的，将此窗口发送到后面，并可能导致它失去焦点或激活，如果它是聚焦或活动窗口。

将此窗口放置在堆叠顺序的底部，并将此窗口显示在该虚拟机的任何其他窗口后面。没有行动会发生是这个窗口是不可见的。一些平台不允许其他窗口所有者拥有的窗口出现在他们的所有者之下。每一次尝试将这个窗口尽可能低的在堆叠顺序，但是，开发人员不应该假设这种方法将移动这个窗口低于所有其他的窗口在每一个情况。

因为在本地窗口系统的变化，不能保证对重点活动窗口可以改变。开发商不认为这个窗口不再是集中到这个窗口或活动窗口接收window_lost_focus或window_deactivated事件。在平台上的最顶层的窗口聚焦窗口，此方法将可能导致这个窗口失去焦点。在这种情况下，下一个最高的，可在这个虚拟机将接收焦点的窗口。平台上的堆叠顺序通常不影响聚焦窗口的地方，这种方法将可能离开集中和活动窗口不变。

如果这个对话框是模式，并阻止一些窗口，那么所有的人也被发送到后面，让他们保持下面的阻塞对话框。

重写：

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

从以下版本开始：

一点四

另请参见：

isUndecorated()， Component.isDisplayable()， Window.getShape()， Window.getOpacity()， Window.getBackground()

isUndecorated

public boolean isUndecorated()

指示此对话框未修饰。默认情况下，所有的对话都是最初的装饰。

结果

true如果对话框未修饰； false否则。

从以下版本开始：

一点四

另请参见：

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。

个别像素的透明度水平也可以通过他们的颜色的alpha分量的影响（见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将抛出。

个别像素的透明度水平也可以通过他们的颜色的alpha分量的影响（见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分量可能这个窗口操作模式的影响：它指示这个窗口必须是不透明的（α等于1.0f）或每像素半透明（α小于1.0f）。如果给定的背景颜色是null，窗户是完全不透明的。

必须满足所有以下条件，以使该窗口的每个像素的透明度模式：

• 半透明的PERPIXEL_TRANSLUCENT必须支持的图形设备，该窗口位于
• 窗口必须是未修饰的（见Frame.setUndecorated(boolean)和setUndecorated(boolean)）
• 窗口不能全屏模式（见GraphicsDevice.setFullScreenWindow(Window)）

如果请求的背景颜色的alpha分量小于1.0f，及任何上述条件不满足，这个窗口的背景颜色不会改变，alpha分量的给定的背景颜色不会影响此窗口的操作模式，无论是UnsupportedOperationException或IllegalComponentStateException将抛出。

当窗口是每一个像素的半透明，绘图子系统尊重每个单独的像素的α值。如果一个像素得到与阿尔法颜色分量等于零，它成为视觉上透明。如果该像素的alpha等于1.0f，像素是完全不透明的。阿尔法颜色组件的临时值使像素半透明。在这种模式下，窗口的背景画与给定的背景颜色的α值。如果这个方法的参数α值等于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

从以下版本开始：

一点三