JavaTM Platform
Standard Ed. 6

java.awt
类 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

Dialog 是一个带标题和边界的顶层窗口,边界一般用于从用户处获得某种形式的输入。Dialog 的大小包括边界所指定的任何区域。边界区的维度可以使用 getInsets 方法获得,但是,由于这些维度是依赖于平台的,因此只有通过调用 packshow 将 dialog 设置为可显示的,才能获得有效的 insets 值。由于 dialog 的总大小包括了边界区,因此边界有效地模糊了 dialog 的部分区域,约束了可用于在矩形中呈现或显示子部件的区域,矩形左上角的位置为 (insets.left, insets.top),宽度为 width - (insets.left + insets.right),长度为 height - (insets.top + insets.bottom)

Dialog 的默认布局为 BorderLayout

Dialog 可以使用 setUndecorated 关闭本机装饰(例如 Frame & Titlebar)。只有在 dialog 不是 displayable 时才能完成此操作。

在构造 dialog 时,dialog 可以拥有另一个窗口作为它自己的窗口。当可见的 dialog 的所有者窗口被最小化时,dialog 会自动隐藏为对用户不可见。当所有者窗口被还原时,dialog 重新又变为用户可见的。

在多屏幕环境中,可以在不同于其所有者的屏幕设备上创建 Dialog。有关更多信息,请参阅 Frame

dialog 可以是无模式的(默认情况下)或有模式的。有模式的 dialog 会阻止将内容输入到应用程序中的其他一些顶层窗口中(将此 dialog 创建为其所有者的所有窗口除外)。有关细节,请参阅 AWT Modality 规范。

Dialog 能够产生以下 WindowEventsWindowOpenedWindowClosingWindowClosedWindowActivatedWindowDeactivatedWindowGainedFocusWindowLostFocus

从以下版本开始:
JDK1.0
另请参见:
WindowEvent, Window.addWindowListener(java.awt.event.WindowListener), 序列化表格

嵌套类摘要
protected  class Dialog.AccessibleAWTDialog
          此类实现对 Dialog 类的可访问性支持。
static class Dialog.ModalExclusionType
          任何顶层窗口都可以标记为不受模式对话框阻塞。
static class Dialog.ModalityType
          模式对话框阻塞对某些顶层窗口的所有输入。
 
从类 java.awt.Window 继承的嵌套类/接口
Window.AccessibleAWTWindow
 
从类 java.awt.Container 继承的嵌套类/接口
Container.AccessibleAWTContainer
 
从类 java.awt.Component 继承的嵌套类/接口
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
字段摘要
static Dialog.ModalityType DEFAULT_MODALITY_TYPE
          有模式 dialog 的默认模式类型。
 
从类 java.awt.Component 继承的字段
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
从接口 java.awt.image.ImageObserver 继承的字段
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
构造方法摘要
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
 
方法摘要
 void addNotify()
          通过将此 Dialog 连接到本机屏幕资源,从而使其成为可显示的。
 AccessibleContext getAccessibleContext()
          获取与此 Dialog 有关的 AccessibleContext。
 Dialog.ModalityType getModalityType()
          返回此 dialog 的模式类型。
 String getTitle()
          获取 dialog 的标题。
 void hide()
          已过时。 从 JDK 版本 1.5 开始,由 setVisible(boolean) 取代。
 boolean isModal()
          指出 dialog 是否为有模式的。
 boolean isResizable()
          指出此 dialog 是否可以由用户调整大小。
 boolean isUndecorated()
          指出此 dialog 是否未装饰。
protected  String paramString()
          返回表示此 dialog 状态的字符串。
 void setModal(boolean modal)
          指定此 dialog 是否应该是有模式的。
 void setModalityType(Dialog.ModalityType type)
          设置此 dialog 的模式类型。
 void setResizable(boolean resizable)
          设置此 dialog 是否可以由用户调整大小。
 void setTitle(String title)
          设置 Dialog 的标题。
 void setUndecorated(boolean undecorated)
          禁用或启用此 dialog 的装饰。
 void setVisible(boolean b)
          根据参数 b 的值显示或隐藏此 Dialog
 void show()
          已过时。 从 JDK 版本 1.5 开始,由 setVisible(boolean) 取代。
 void toBack()
          如果此窗口是可视的,则将此窗口置于后方,如果它是焦点窗口或活动窗口,则会导致丢失焦点或活动状态。
 
从类 java.awt.Window 继承的方法
addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOwnedWindows, getOwner, getOwnerlessWindows, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, processEvent, processWindowEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, 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, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusBackward, 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, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, 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, isOpaque, 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, setBackground, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, 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
有模式 dialog 的默认模式类型。默认模式类型是 APPLICATION_MODAL。调用旧式 setModal(true) 等效于调用 setModalityType(DEFAULT_MODALITY_TYPE)

从以下版本开始:
1.6
另请参见:
Dialog.ModalityType, setModal(boolean)
构造方法详细信息

Dialog

public Dialog(Frame owner)
构造一个最初不可见的、无模式的 Dialog,它带有指定所有者 Frame 和一个空标题。

参数:
owner - dialog 的所有者,如果此 dialog 没有所有者,则该参数为 null
抛出:
IllegalArgumentException - 如果 ownerGraphicsConfiguration 不是来自某一屏幕设备
HeadlessException - 当 GraphicsEnvironment.isHeadless() 返回 true
另请参见:
GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean)

Dialog

public Dialog(Frame owner,
              boolean modal)
构造一个最初不可见的 Dialog,它带有指定所有者 Frame、模式和一个空标题。

参数:
owner - dialog 的所有者,如果此 dialog 没有所有者,则该参数为 null
modal - 指定在显示的时候是否阻止用户将内容输入到其他顶级窗口中。如果该参数为 false,则 dialog 是 MODELESS;如果该参数为 true,则模式类型属性被设置为 DEFAULT_MODALITY_TYPE
抛出:
IllegalArgumentException - 如果 ownerGraphicsConfiguration 不是来自某一屏幕设备
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 - dialog 的所有者,如果此 dialog 没有所有者,则该参数为 null
title - dialog 的标题,如果此 dialog 没有标题,则该参数为 null
抛出:
IllegalArgumentException - 如果 ownerGraphicsConfiguration 不是来自某一屏幕设备
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 - dialog 的所有者,如果此 dialog 没有所有者,则该参数为 null
title - dialog 的标题,如果此 dialog 没有标题,则该参数为 null
modal - 指定在显示的时候是否阻止用户将内容输入到其他顶级窗口中。如果该参数为 false,则 dialog 是 MODELESS;如果该参数为 true,则模式类型属性被设置为 DEFAULT_MODALITY_TYPE
抛出:
IllegalArgumentException - 如果 ownerGraphicsConfiguration 不是来自某一屏幕设备
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 - dialog 的所有者,如果此 dialog 没有所有者,则该参数为 null
title - dialog 的标题,如果此 dialog 没有标题,则该参数为 null
modal - 指定在显示的时候是否阻止用户将内容输入到其他顶级窗口中。如果该参数为 false,则 dialog 是 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 - dialog 的所有者,如果此 dialog 没有所有者,则该参数为 null
抛出:
IllegalArgumentException - 如果 ownerGraphicsConfiguration 不是来自某一屏幕设备
HeadlessException - 当 GraphicsEnvironment.isHeadless() 返回 true
从以下版本开始:
1.2
另请参见:
GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Dialog owner,
              String title)
构造一个最初不可见的、无模式的 Dialog,它带有指定的所有者 Dialog 和标题。

参数:
owner - dialog 的所有者,如果此 dialog 没有所有者,则该参数为 null
title - dialog 的标题,如果此 dialog 没有标题,则该参数为 null
抛出:
IllegalArgumentException - 如果 ownerGraphicsConfiguration 不是来自某一屏幕设备
HeadlessException - 当 GraphicsEnvironment.isHeadless() 返回 true
从以下版本开始:
1.2
另请参见:
GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Dialog owner,
              String title,
              boolean modal)
构造一个最初不可见的 Dialog,它带有指定的所有者 Dialog、标题和模式。

参数:
owner - dialog 的所有者,如果此 dialog 没有所有者,则该参数为 null
title - dialog 的标题,如果此 dialog 没有标题,则该参数为 null
modal - 指定在显示的时候是否阻止用户将内容输入到其他顶级窗口中。如果该参数为 false,则 dialog 是 MODELESS;如果该参数为 true,则模式类型属性被设置为 DEFAULT_MODALITY_TYPE
抛出:
IllegalArgumentException - 如果 ownerGraphicsConfiguration 不是来自某一屏幕设备
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 - dialog 的所有者,如果此 dialog 没有所有者,则该参数为 null
title - dialog 的标题,如果此 dialog 没有标题,则该参数为 null
modal - 指定在显示的时候是否阻止用户将内容输入到其他顶级窗口中。如果该参数为 false,则 dialog 是 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 的所有者。该所有者必须是 DialogFrame 以及它们的任何后代的实例,或者是 null
抛出:
IllegalArgumentException - 如果 owner 不是 DialogFrame 实例
IllegalArgumentException - 如果 ownerGraphicsConfiguration 不是来自屏幕设备
HeadlessException - 当 GraphicsEnvironment.isHeadless() 返回 true
从以下版本开始:
1.6
另请参见:
GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Window owner,
              String title)
构造一个最初不可见的、无模式的 Dialog,它带有指定的所有者 Window 和标题。

参数:
owner - dialog 的所有者。该所有者必须是 DialogFrame 以及它们的任何后代的实例,或者是 null
title - dialog 的标题,如果此 dialog 没有标题,则该参数为 null
抛出:
IllegalArgumentException - 如果 owner 不是 DialogFrame 实例
IllegalArgumentException - 如果 ownerGraphicsConfiguration 不是来自屏幕设备
HeadlessException - 当 GraphicsEnvironment.isHeadless() 返回 true
从以下版本开始:
1.6
另请参见:
GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Window owner,
              Dialog.ModalityType modalityType)
构造一个最初不可见的 Dialog,它带有指定所有者 Window、模式和一个空标题。

参数:
owner - dialog 的所有者。该所有者必须是 DialogFrame 以及它们的任何后代的实例,或者是 null
modalityType - 指定 dialog 是否阻止用户在显示的时候将内容输入其他窗口。 null 值和不受支持的模式类型等效于 MODELESS
抛出:
IllegalArgumentException - 如果 owner 不是 DialogFrame 实例
IllegalArgumentException - 如果 ownerGraphicsConfiguration 不是来自某个屏幕设备
HeadlessException - 当 GraphicsEnvironment.isHeadless() 返回 true
SecurityException - 如果调用线程没有使用给定 modalityType 创建有模式 dialog 的权限
从以下版本开始:
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 的所有者。该所有者必须是 DialogFrame 以及它们的任何后代的实例,或者是 null
title - dialog 的标题,如果此 dialog 没有标题,则该参数为 null
modalityType - 指定 dialog 是否阻止用户在显示的时候将内容输入其他窗口中。 null 值和不受支持的模式类型等效于 MODELESS
抛出:
IllegalArgumentException - 如果 owner 不是 DialogFrame 实例
IllegalArgumentException - 如果 ownerGraphicsConfiguration 不是来自某个屏幕设备
HeadlessException - 当 GraphicsEnvironment.isHeadless() 返回 true
SecurityException - 如果调用线程没有使用给定 modalityType 创建有模式 dialog 的权限
从以下版本开始:
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 的所有者。该所有者必须是 DialogFrame 以及它们的任何后代的实例,或者是 null
title - dialog 的标题,如果此 dialog 没有标题,则该参数为 null
modalityType - 指定 dialog 是否阻止用户在显示的时候将内容输入其他窗口。 null 值和不受支持的模式类型等效于 MODELESS
gc - 目标屏幕设备的 GraphicsConfiguration;如果该参数为 null,则假定默认系统为 GraphicsConfiguration
抛出:
IllegalArgumentException - 如果 owner 不是 DialogFrame 实例
IllegalArgumentException - 如果 gc 不是来自某一屏幕设备
HeadlessException - 当 GraphicsEnvironment.isHeadless() 返回 true
SecurityException - 如果调用线程没有使用给定 modalityType 创建有模式 dialog 的权限
从以下版本开始:
1.6
另请参见:
Dialog.ModalityType, setModal(boolean), setModalityType(java.awt.Dialog.ModalityType), GraphicsEnvironment.isHeadless(), Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)
方法详细信息

addNotify

public void addNotify()
通过将此 Dialog 连接到本机屏幕资源,从而使其成为可显示的。如果 dialog 是可显示的,则其所有子级也将成为可显示的。由工具包在内部调用此方法,而不应该直接由程序调用。

覆盖:
Window 中的 addNotify
另请参见:
Component.isDisplayable(), Window.removeNotify()

isModal

public boolean isModal()
指出 dialog 是否为有模式的。

此方法已过时,保留它只是为了后向兼容。可以使用 getModalityType() 代替。

返回:
如果此 dialog 窗口是有模式的,则返回 true;否则返回 false
另请参见:
DEFAULT_MODALITY_TYPE, Dialog.ModalityType.MODELESS, setModal(boolean), getModalityType(), setModalityType(java.awt.Dialog.ModalityType)

setModal

public void setModal(boolean modal)
指定此 dialog 是否应该是有模式的。

此方法已过时,保留它只是为了后向兼容。可以使用 setModalityType() 代替。

注:更改可见 dialog 的模式只在隐藏该 dialog 并再次显示它时产生效果。

参数:
modal - 指定 dialog 是否阻止在显示的时候将内容输入其他窗口;调用 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()
返回此 dialog 的模式类型。

返回:
此 dialog 的模式类型
从以下版本开始:
1.6
另请参见:
setModalityType(java.awt.Dialog.ModalityType)

setModalityType

public void setModalityType(Dialog.ModalityType type)
设置此 dialog 的模式类型。有关可能的模式类型,请参阅 ModalityType

如果给定模式类型不受支持,则使用 MODELESS。您可能想在调用此方法之后调用 getModalityType(),以确保模式类型已被设置。

注:更改可见 dialog 的模式只在隐藏该 dialog 并再次显示它时产生效果。

参数:
type - 指定 dialog 是否阻止在显示的时候将内容输入其他窗口。 null 值和不受支持的模式类型等效于 MODELESS
抛出:
SecurityException - 如果调用线程没有使用给定 modalityType 创建有模式 dialog 的权限
从以下版本开始:
1.6
另请参见:
getModalityType(), Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)

getTitle

public String getTitle()
获取 dialog 的标题。标题显示在 dialog 的边界中。

返回:
此 dialog 窗口的标题。标题可以为 null
另请参见:
setTitle(java.lang.String)

setTitle

public void setTitle(String title)
设置 Dialog 的标题。

参数:
title - 显示在 dialog 的边界中的标题;null 值会导致一个空标题
另请参见:
getTitle()

setVisible

public void setVisible(boolean b)
根据参数 b 的值显示或隐藏此 Dialog

覆盖:
Window 中的 setVisible
参数:
b - 如果该参数为 true,则使 Dialog 可见,否则隐藏 Dialog。如果 dialog 和/或其所有者尚不可显示,则使它们都变成可显示的。在使 dialog 可见之前,将验证该 dialog。如果该参数为 false,则隐藏 Dialog,并且随后导致返回 setVisible(true)(如果它目前受阻塞)。

对有模式 dialog 的注释

  • setVisible(true):如果 dialog 尚不可见,则在通过调用 setVisible(false)dispose 隐藏 dialog 之前,此调用不会返回。
  • setVisible(false):隐藏 dialog,然后返回 setVisible(true)(如果它目前受阻塞)。
  • 从事件指派线程调用此方法是受允许的,因为在此方法受阻塞时,工具包会确保其他事件不受阻塞。
另请参见:
Window.setVisible(boolean), Window.dispose(), Component.isDisplayable(), Component.validate(), isModal()

show

@Deprecated
public void show()
已过时。  从 JDK 版本 1.5 开始,由 setVisible(boolean) 取代。

使 Dialog 可见。如果 dialog 和/或其所有者尚不可显示,则使它们都变成可显示的。在使 dialog 可见之前,将验证该 dialog。如果 dialog 已经可见,则此方法会使 dialog 显示在前面。

如果 dialog 是有模式的并且尚不可见,则在通过调用 hide 或 dispose 方法隐藏 dialog 之前,此调用不会返回。从事件指派线程显示有模式 dialog 是受允许的,因为调用此方法的线程受阻塞时,工具包会确保另一个事件队列的运行。

覆盖:
Window 中的 show
另请参见:
Component.hide(), Component.isDisplayable(), Component.validate(), isModal(), Window.setVisible(boolean)

hide

@Deprecated
public void hide()
已过时。  从 JDK 版本 1.5 开始,由 setVisible(boolean) 取代。

隐藏 Dialog 并随后导致返回 show(如果它目前受阻塞)。

覆盖:
Window 中的 hide
另请参见:
Window.show(), Window.dispose(), Window.setVisible(boolean)

toBack

public void toBack()
如果此窗口是可视的,则将此窗口置于后方,如果它是焦点窗口或活动窗口,则会导致丢失焦点或活动状态。

在此虚拟机中,将此窗口放在堆栈顺序的底部,并在其他所有窗口之后显示此窗口。如果此窗口不可见,则不发生任何操作。有些平台不允许其他窗口拥有的窗口出现在其所有者下方。将进行所有尝试来移动此窗口,使其位于堆栈顺序中尽可能靠后的位置;不过,开发人员不应假定此方法在所有情况下都可以将此窗口移到所有其他窗口之下。

由于本机窗口系统多种多样,因此无法保证对焦点窗口和活动窗口的更改能够实现。在此窗口接收 WINDOW_LOST_FOCUS 或 WINDOW_DEACTIVATED 事件之前,开发人员不得假定此窗口不再是焦点窗口或活动窗口。在顶层窗口为焦点窗口的平台上,此方法可能导致此窗口不再是焦点状态。在此情况下,此虚拟机中紧跟其后的可作为焦点的窗口将成为焦点窗口。在堆栈顺序通常不影响焦点窗口的平台上,此方法可能维持焦点窗口和活动窗口不变。

如果此 dialog 是有模式的并且阻止某些窗口,则所有 dialog 都被发送回来,使它们位于正受阻塞的 dialog 下。

覆盖:
Window 中的 toBack
另请参见:
Window.toBack()

isResizable

public boolean isResizable()
指出此 dialog 是否可以由用户调整大小。默认情况下,所有 dialog 最初都是可调整的。

返回:
如果用户可以调整 dialog 的大小,则返回 true;否则返回 false
另请参见:
setResizable(boolean)

setResizable

public void setResizable(boolean resizable)
设置此 dialog 是否可以由用户调整大小。

参数:
resizable - 如果用户可以调整 dialog 的大小,则返回 true;否则返回 false
另请参见:
isResizable()

setUndecorated

public void setUndecorated(boolean undecorated)
禁用或启用此 dialog 的装饰。只有在 dialog 不可显示时才调用此方法。

参数:
undecorated - 如果没有启用 dialog 装饰,则为 true;如果启用了 dialog 装饰,则为 false
抛出:
IllegalComponentStateException - 如果 dialog 是可显示的。
从以下版本开始:
1.4
另请参见:
isUndecorated(), Component.isDisplayable()

isUndecorated

public boolean isUndecorated()
指出此 dialog 是否未装饰。在默认情况下,所有 dialog 最初都是已装饰的。

返回:
如果 dialog 为未装饰,则为 true;否则为 false
从以下版本开始:
1.4
另请参见:
setUndecorated(boolean)

paramString

protected String paramString()
返回表示此 dialog 状态的字符串。此方法仅用于调试目的,对于这两种实现,返回字符串的内容和格式可能有所不同。返回的字符串可能为空,但不可能为 null

覆盖:
Container 中的 paramString
返回:
此 dialog 窗口的参数字符串。

getAccessibleContext

public AccessibleContext getAccessibleContext()
获取与此 Dialog 有关的 AccessibleContext。对于 dialog 来说,AccessibleContext 采用 AccessibleAWTDialog 的某种形式。必要时创建一个新的 AccessibleAWTDialog 实例。

指定者:
接口 Accessible 中的 getAccessibleContext
覆盖:
Window 中的 getAccessibleContext
返回:
AccessibleAWTDialog,用作此 Dialog 的 AccessibleContext
从以下版本开始:
1.3

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策