|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.awt.Component java.awt.Container java.awt.Window java.awt.Dialog
public class Dialog
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
。
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.lang.Object 继承的方法 |
---|
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
构造方法详细信息 |
---|
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)
public Dialog(Frame owner, boolean modal)
Dialog
,带有空标题、指定的所有者框架和模式。
owner
- Dialog 的所有者modal
- 如果为 true
,则 dialog 将阻断输入到其他应用程序窗口显示的内容
IllegalArgumentException
- 如果 owner
的 GraphicsConfiguration
不是来自屏幕设备
IllegalArgumentException
- 如果 owner
为 null
;当 GraphicsEnvironment.isHeadless
返回 true
时总会抛出此异常GraphicsEnvironment.isHeadless()
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)
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)
public Dialog(Frame owner, String title, boolean modal, GraphicsConfiguration gc)
GraphicsConfiguration
。
owner
- Dialog 的所有者title
- Dialog 的标题。null
值将被接受,而不会抛出 NullPointerException。modal
- 如果为 true,则 dialog 将阻断输入到其他应用程序窗口显示的内容gc
- 目标屏幕设备的 GraphicsConfiguration
。如果 gc
为 null
,则使用与所拥有的 Frame 相同的 GraphicsConfiguration
。
IllegalArgumentException
- 如果 owner
为 null
。当 GraphicsEnvironment.isHeadless() 返回 true 时总会抛出异常GraphicsEnvironment.isHeadless()
,
Component.setSize(int, int)
,
Component.setVisible(boolean)
public Dialog(Dialog owner)
owner
- Dialog 的所有者
IllegalArgumentException
- 如果 owner
为 null
。当 GraphicsEnvironment.isHeadless() 返回 true 时总会抛出此异常GraphicsEnvironment.isHeadless()
public Dialog(Dialog owner, String title)
owner
- Dialog 的所有者title
- Dialog 的标题。null
值将被接受,而不会抛出 NullPointerException。
IllegalArgumentException
- 如果 owner
为 null
。当 GraphicsEnvironment.isHeadless() 返回 true 时总会抛出此异常GraphicsEnvironment.isHeadless()
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
时总会抛出此异常GraphicsEnvironment.isHeadless()
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
时总会抛出此异常GraphicsEnvironment.isHeadless()
,
Component.setSize(int, int)
,
Component.setVisible(boolean)
方法详细信息 |
---|
public void addNotify()
Window
中的 addNotify
Component.isDisplayable()
,
Container.removeNotify()
public boolean isModal()
true
;否则返回 false
。setModal(boolean)
public void setModal(boolean b)
isModal()
public String getTitle()
null
。setTitle(java.lang.String)
public void setTitle(String title)
title
- 显示在 dialog 的边界中的标题;null 值会导致一个空标题getTitle()
@Deprecated public void show()
Component.setVisible(boolean)
取代。
Window
中的 show
@Deprecated public void hide()
Component.setVisible(boolean)
取代。
Window
中的 hide
public boolean isResizable()
true
;否则返回 false
。setResizable(boolean)
public void setResizable(boolean resizable)
resizable
- 如果用户可以调整 dialog 的大小,则返回 true
;否则返回 false
。isResizable()
public void setUndecorated(boolean undecorated)
undecorated
- 如果没有启用 dialog 装饰,则为 true
;如果启用了 dialog 装饰,则为 false
。
IllegalComponentStateException
- 如果 dialog 是可显示的。isUndecorated()
,
Component.isDisplayable()
public boolean isUndecorated()
true
;否则为 false
。setUndecorated(boolean)
protected String paramString()
null
。
Container
中的 paramString
public AccessibleContext getAccessibleContext()
Accessible
中的 getAccessibleContext
Window
中的 getAccessibleContext
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。