Dialog (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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
extends Window

Dialog 是一个带标题和边界的顶层窗口，边界一般用于从用户处获得某种形式的输入。 Dialog 的大小包括边界所指定的任何区域。边界区的维度可以使用 getInsets 方法获得，但是，由于这些维度是依赖于平台的，因此只有通过调用 pack 或 show 将 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 作为其所有者创建的窗口除外）。

Dialog 能够产生以下 WindowEvents：WindowOpened、WindowClosing、WindowClosed、WindowActivated、WindowDeactivated、WindowGainedFocus、WindowLostFocus。

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

嵌套类摘要
`protected class`	`Dialog.AccessibleAWTDialog` 此类实现对 `Dialog` 类的可访问性支持。

从类 java.awt.Window 继承的嵌套类/接口
`Window.AccessibleAWTWindow`

从类 java.awt.Container 继承的嵌套类/接口
`Container.AccessibleAWTContainer`

从类 java.awt.Component 继承的嵌套类/接口
`Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy`

从类 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 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`，带有空标题和指定的所有者框架。
`Dialog(Frame owner, boolean modal)` 构造一个初始时不可见的 `Dialog`，带有空标题、指定的所有者框架和模式。
`Dialog(Frame owner, String title)` 构造一个初始时不可见、无模式的 `Dialog`，带有指定的所有者框架和标题。
`Dialog(Frame owner, String title, boolean modal)` 构造一个初始时不可见的 `Dialog`，带有指定的所有者框架、标题和模式。
`Dialog(Frame owner, String title, boolean modal, GraphicsConfiguration gc)` 构造一个初始时不可见的 Dialog，带有指定的所有者框架、标题、模式和 `GraphicsConfiguration`。

方法摘要
`void`	`addNotify()` 通过将此 Dialog 连接到本机屏幕资源，从而使其成为可显示的。
`AccessibleContext`	`getAccessibleContext()` 获得与此 Dialog 有关的 AccessibleContext。
`String`	`getTitle()` 获得 dialog 的标题。
`void`	`hide()` 已过时。从 JDK version 1.5 开始，由 `Component.setVisible(boolean)` 取代。
`boolean`	`isModal()` 指出 dialog 是否为有模式的。
`boolean`	`isResizable()` 指出此 dialog 是否可以由用户调整大小。
`boolean`	`isUndecorated()` 指出此 dialog 是否未装饰。
`protected String`	`paramString()` 返回表示此 dialog 状态的字符串。
`void`	`setModal(boolean b)` 指定此 dialog 是否应该是有模式的。
`void`	`setResizable(boolean resizable)` 设置此 dialog 是否可以由用户调整大小。
`void`	`setTitle(String title)` 设置 Dialog 的标题。
`void`	`setUndecorated(boolean undecorated)` 禁用或启用此 dialog 的装饰。
`void`	`show()` 已过时。从 JDK version 1.5 开始，由 `Component.setVisible(boolean)` 取代。

从类 java.awt.Window 继承的方法
addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, finalize, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getMostRecentFocusOwner, getOwnedWindows, getOwner, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindowStateListeners, isActive, isAlwaysOnTop, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, processEvent, processWindowEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, setAlwaysOnTop, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setLocationByPlatform, setLocationRelativeTo, toBack, 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, removeNotify, 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, 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, reshape, resize, resize, setBackground, setBounds, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, size, toString, transferFocus, transferFocusUpCycle

从类 java.lang.Object 继承的方法
`clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait`

构造方法详细信息

Dialog

public Dialog(Frame owner)

构造一个初始时不可见、无模式的 Dialog，带有空标题和指定的所有者框架。

参数：: owner - Dialog 的所有者
抛出：: IllegalArgumentException - 如果 owner 的 GraphicsConfiguration 不是来自屏幕设备; IllegalArgumentException - 如果 owner 为 null；当 GraphicsEnvironment.isHeadless 返回 true 时总会抛出此异常
另请参见：: GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean)

Dialog

public Dialog(Frame owner,
              boolean modal)

构造一个初始时不可见的 Dialog，带有空标题、指定的所有者框架和模式。

参数：: owner - Dialog 的所有者; modal - 如果为 true，则 dialog 将阻断输入到其他应用程序窗口显示的内容
抛出：: IllegalArgumentException - 如果 owner 的 GraphicsConfiguration 不是来自屏幕设备; IllegalArgumentException - 如果 owner 为 null；当 GraphicsEnvironment.isHeadless 返回 true 时总会抛出此异常
另请参见：: GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Frame owner,
              String title)

构造一个初始时不可见、无模式的 Dialog，带有指定的所有者框架和标题。

参数：: owner - Dialog 的所有者; title - Dialog 的标题 null 值可以被接受，而不会抛出 NullPointerException
抛出：: IllegalArgumentException - 如果 owner 的 GraphicsConfiguration 不是来自屏幕设备; IllegalArgumentException - 如果 owner 为 null；当 GraphicsEnvironment.isHeadless 返回 true 时总会抛出此异常
另请参见：: GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean)

Dialog

public Dialog(Frame owner,
              String title,
              boolean modal)

构造一个初始时不可见的 Dialog，带有指定的所有者框架、标题和模式。

参数：: owner - Dialog 的所有者; title - Dialog 的标题 null 值将被接受，而不会抛出 NullPointerException; modal - 如果为 true，则 dialog 将阻断输入到其他应用程序窗口显示的内容
抛出：: IllegalArgumentException - 如果 owner 的 GraphicsConfiguration 不是来自屏幕设备; IllegalArgumentException - 如果 owner 为 null。当 GraphicsEnvironment.isHeadless 返回 true 时总会抛出此异常
另请参见：: GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean)

Dialog

public Dialog(Frame owner,
              String title,
              boolean modal,
              GraphicsConfiguration gc)

构造一个初始时不可见的 Dialog，带有指定的所有者框架、标题、模式和 GraphicsConfiguration。

参数：: owner - Dialog 的所有者; title - Dialog 的标题。null 值将被接受，而不会抛出 NullPointerException。; modal - 如果为 true，则 dialog 将阻断输入到其他应用程序窗口显示的内容; gc - 目标屏幕设备的 GraphicsConfiguration。如果 gc 为 null，则使用与所拥有的 Frame 相同的 GraphicsConfiguration。
抛出：: IllegalArgumentException - 如果 owner 为 null。当 GraphicsEnvironment.isHeadless() 返回 true 时总会抛出异常
从以下版本开始：: 1.4
另请参见：: GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean)

Dialog

public Dialog(Dialog owner)

构造一个初始时不可见，无模式的 Dialog，带有空标题和指定的所有者框架。

参数：: owner - Dialog 的所有者
抛出：: IllegalArgumentException - 如果 owner 为 null。当 GraphicsEnvironment.isHeadless() 返回 true 时总会抛出此异常
从以下版本开始：: 1.2
另请参见：: GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Dialog owner,
              String title)

构造一个初始时不可见、无模式的 Dialog，带有指定的所有者 dialog 和标题。

参数：: owner - Dialog 的所有者; title - Dialog 的标题。null 值将被接受，而不会抛出 NullPointerException。
抛出：: IllegalArgumentException - 如果 owner 为 null。当 GraphicsEnvironment.isHeadless() 返回 true 时总会抛出此异常
从以下版本开始：: 1.2
另请参见：: GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Dialog owner,
              String title,
              boolean modal)

构造一个初始时不可见的 Dialog,带有指定的所有者 dialog、标题和模式。

参数：: owner - Dialog 的所有者; title - Dialog 的标题；null 值可以被接受，而不会抛出 NullPointerException; modal - 如果为真，则 dialog 将阻断输入到其他应用程序窗口显示的内容
抛出：: IllegalArgumentException - 如果 owner 的 GraphicsConfiguration 不是来自屏幕设备; IllegalArgumentException - 如果 owner 为 null；当 GraphicsEnvironment.isHeadless 返回 true 时总会抛出此异常
从以下版本开始：: 1.2
另请参见：: GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Dialog owner,
              String title,
              boolean modal,
              GraphicsConfiguration gc)

构造一个初始时不可见的 Dialog，带有指定的所有者 dialog、标题、模式和 GraphicsConfiguration。

参数：: owner - Dialog 的所有者; title - Dialog 的所有者 null 值将被接受，而不会抛出 NullPointerException; modal - 如果为 true，则 dialog 将阻断输入到其他应用程序窗口显示的内容; gc - 目标屏幕设备的 GraphicsConfiguration；如果 gc 为 null，则使用与所拥有的 Dialog 相同的 GraphicsConfiguration
抛出：: IllegalArgumentException - 如果 owner 的 GraphicsConfiguration 不是来自屏幕设备; IllegalArgumentException - 如果 owner 为 null；当 GraphicsEnvironment.isHeadless 返回 true 时总会抛出此异常
从以下版本开始：: 1.4
另请参见：: GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean)

方法详细信息

addNotify

public void addNotify()

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

覆盖：: 类 Window 中的 addNotify

另请参见：: Component.isDisplayable(), Container.removeNotify()

isModal

public boolean isModal()

指出 dialog 是否为有模式的。当有模式的 Dialog 为可见时，用户输入到应用程序中其他窗口的内容将被阻断（将此 dialog 作为其所有者创建的窗口除外）

返回：: 如果此 dialog 窗口是有模式的，则返回 true；否则返回 false。
另请参见：: setModal(boolean)

setModal

public void setModal(boolean b)

指定此 dialog 是否应该是有模式的。

从以下版本开始：: JDK1.1
另请参见：: isModal()

getTitle

public String getTitle()

获得 dialog 的标题。标题显示在 dialog 的边界中。

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

setTitle

public void setTitle(String title)

设置 Dialog 的标题。

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

show

@Deprecated
public void show()

已过时。 从 JDK version 1.5 开始，由 Component.setVisible(boolean) 取代。

覆盖：: 类 Window 中的 show

hide

@Deprecated
public void hide()

已过时。 从 JDK version 1.5 开始，由 Component.setVisible(boolean) 取代。

覆盖：: 类 Window 中的 hide

isResizable

public boolean isResizable()

指出此 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

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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

Dialog (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

java.awt 类 Dialog

Dialog

Dialog

Dialog

Dialog

Dialog

Dialog

Dialog

Dialog

Dialog

addNotify

isModal

setModal

getTitle

setTitle

show

hide

isResizable

setResizable

setUndecorated

isUndecorated

paramString

getAccessibleContext

java.awt
类 Dialog