©
本文档使用 PHP中文网手册 发布
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
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 创建为其所有者的所有窗口除外)。有关细节,请参阅 AWT Modality 规范。
Dialog 能够产生以下 WindowEvents
:WindowOpened
、WindowClosing
、WindowClosed
、WindowActivated
、WindowDeactivated
、WindowGainedFocus
、WindowLostFocus
。
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 |
字段详细信息 |
---|
public static final Dialog.ModalityType DEFAULT_MODALITY_TYPE
APPLICATION_MODAL
。调用旧式 setModal(true)
等效于调用 setModalityType(DEFAULT_MODALITY_TYPE)
。
Dialog.ModalityType
,
setModal(boolean)
构造方法详细信息 |
---|
public Dialog(Frame owner)
Dialog
,它带有指定所有者 Frame
和一个空标题。
owner
- dialog 的所有者,如果此 dialog 没有所有者,则该参数为 null
IllegalArgumentException
- 如果 owner
的 GraphicsConfiguration
不是来自某一屏幕设备
HeadlessException
- 当 GraphicsEnvironment.isHeadless()
返回 true
时GraphicsEnvironment.isHeadless()
,
Component.setSize(int, int)
,
Component.setVisible(boolean)
public Dialog(Frame owner, boolean modal)
Dialog
,它带有指定所有者 Frame
、模式和一个空标题。
owner
- dialog 的所有者,如果此 dialog 没有所有者,则该参数为 null
modal
- 指定在显示的时候是否阻止用户将内容输入到其他顶级窗口中。如果该参数为 false
,则 dialog 是 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()
public Dialog(Frame owner, String title)
Dialog
,它带有指定的所有者 Frame
和标题。
owner
- dialog 的所有者,如果此 dialog 没有所有者,则该参数为 null
title
- dialog 的标题,如果此 dialog 没有标题,则该参数为 null
IllegalArgumentException
- 如果 owner
的 GraphicsConfiguration
不是来自某一屏幕设备
HeadlessException
- 当 GraphicsEnvironment.isHeadless()
返回 true
时GraphicsEnvironment.isHeadless()
,
Component.setSize(int, int)
,
Component.setVisible(boolean)
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
- 如果 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)
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
时Dialog.ModalityType
,
Dialog.ModalityType.MODELESS
,
DEFAULT_MODALITY_TYPE
,
setModal(boolean)
,
setModalityType(java.awt.Dialog.ModalityType)
,
GraphicsEnvironment.isHeadless()
,
Component.setSize(int, int)
,
Component.setVisible(boolean)
public Dialog(Dialog owner)
Dialog
,它带有指定所有者 Dialog
和一个空标题。
owner
- dialog 的所有者,如果此 dialog 没有所有者,则该参数为 null
IllegalArgumentException
- 如果 owner
的 GraphicsConfiguration
不是来自某一屏幕设备
HeadlessException
- 当 GraphicsEnvironment.isHeadless()
返回 true
时GraphicsEnvironment.isHeadless()
public Dialog(Dialog owner, String title)
Dialog
,它带有指定的所有者 Dialog
和标题。
owner
- dialog 的所有者,如果此 dialog 没有所有者,则该参数为 null
title
- dialog 的标题,如果此 dialog 没有标题,则该参数为 null
IllegalArgumentException
- 如果 owner
的 GraphicsConfiguration
不是来自某一屏幕设备
HeadlessException
- 当 GraphicsEnvironment.isHeadless()
返回 true
时GraphicsEnvironment.isHeadless()
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
- 如果 owner
的 GraphicsConfiguration
不是来自某一屏幕设备
HeadlessException
- 当 GraphicsEnvironment.isHeadless()
返回 true
时Dialog.ModalityType
,
Dialog.ModalityType.MODELESS
,
DEFAULT_MODALITY_TYPE
,
setModal(boolean)
,
setModalityType(java.awt.Dialog.ModalityType)
,
GraphicsEnvironment.isHeadless()
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
时Dialog.ModalityType
,
Dialog.ModalityType.MODELESS
,
DEFAULT_MODALITY_TYPE
,
setModal(boolean)
,
setModalityType(java.awt.Dialog.ModalityType)
,
GraphicsEnvironment.isHeadless()
,
Component.setSize(int, int)
,
Component.setVisible(boolean)
public Dialog(Window owner)
Dialog
,它带有指定所有者 Window
和一个空标题。
owner
- dialog 的所有者。该所有者必须是 Dialog
、Frame
以及它们的任何后代的实例,或者是 null
IllegalArgumentException
- 如果 owner
不是 Dialog
或 Frame
实例
IllegalArgumentException
- 如果 owner
的 GraphicsConfiguration
不是来自屏幕设备
HeadlessException
- 当 GraphicsEnvironment.isHeadless()
返回 true
时GraphicsEnvironment.isHeadless()
public Dialog(Window owner, String title)
Dialog
,它带有指定的所有者 Window
和标题。
owner
- dialog 的所有者。该所有者必须是 Dialog
、Frame
以及它们的任何后代的实例,或者是 null
title
- dialog 的标题,如果此 dialog 没有标题,则该参数为 null
IllegalArgumentException
- 如果 owner
不是 Dialog
或 Frame
实例
IllegalArgumentException
- 如果 owner
的 GraphicsConfiguration
不是来自屏幕设备
HeadlessException
- 当 GraphicsEnvironment.isHeadless()
返回 true
时GraphicsEnvironment.isHeadless()
public Dialog(Window owner, Dialog.ModalityType modalityType)
Dialog
,它带有指定所有者 Window
、模式和一个空标题。
owner
- dialog 的所有者。该所有者必须是 Dialog
、Frame
以及它们的任何后代的实例,或者是 null
modalityType
- 指定 dialog 是否阻止用户在显示的时候将内容输入其他窗口。null
值和不受支持的模式类型等效于 MODELESS
IllegalArgumentException
- 如果 owner
不是 Dialog
或 Frame
实例
IllegalArgumentException
- 如果 owner
的 GraphicsConfiguration
不是来自某个屏幕设备
HeadlessException
- 当 GraphicsEnvironment.isHeadless()
返回 true
时
SecurityException
- 如果调用线程没有使用给定 modalityType
创建有模式 dialog 的权限Dialog.ModalityType
,
setModal(boolean)
,
setModalityType(java.awt.Dialog.ModalityType)
,
GraphicsEnvironment.isHeadless()
,
Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)
public Dialog(Window owner, String title, Dialog.ModalityType modalityType)
Dialog
,它带有指定的所有者 Window
、标题和模式。
owner
- dialog 的所有者。该所有者必须是 Dialog
、Frame
以及它们的任何后代的实例,或者是 null
title
- dialog 的标题,如果此 dialog 没有标题,则该参数为 null
modalityType
- 指定 dialog 是否阻止用户在显示的时候将内容输入其他窗口中。null
值和不受支持的模式类型等效于 MODELESS
IllegalArgumentException
- 如果 owner
不是 Dialog
或 Frame
实例
IllegalArgumentException
- 如果 owner
的 GraphicsConfiguration
不是来自某个屏幕设备
HeadlessException
- 当 GraphicsEnvironment.isHeadless()
返回 true
时
SecurityException
- 如果调用线程没有使用给定 modalityType
创建有模式 dialog 的权限Dialog.ModalityType
,
setModal(boolean)
,
setModalityType(java.awt.Dialog.ModalityType)
,
GraphicsEnvironment.isHeadless()
,
Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)
public Dialog(Window owner, String title, Dialog.ModalityType modalityType, GraphicsConfiguration gc)
Dialog
,它带有指定的所有者 Window
、标题、模式和 GraphicsConfiguration
。
owner
- dialog 的所有者。该所有者必须是 Dialog
、Frame
以及它们的任何后代的实例,或者是 null
title
- dialog 的标题,如果此 dialog 没有标题,则该参数为 null
modalityType
- 指定 dialog 是否阻止用户在显示的时候将内容输入其他窗口。null
值和不受支持的模式类型等效于 MODELESS
gc
- 目标屏幕设备的 GraphicsConfiguration
;如果该参数为 null
,则假定默认系统为 GraphicsConfiguration
IllegalArgumentException
- 如果 owner
不是 Dialog
或 Frame
实例
IllegalArgumentException
- 如果 gc
不是来自某一屏幕设备
HeadlessException
- 当 GraphicsEnvironment.isHeadless()
返回 true
时
SecurityException
- 如果调用线程没有使用给定 modalityType
创建有模式 dialog 的权限Dialog.ModalityType
,
setModal(boolean)
,
setModalityType(java.awt.Dialog.ModalityType)
,
GraphicsEnvironment.isHeadless()
,
Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)
方法详细信息 |
---|
public void addNotify()
Window
中的 addNotify
Component.isDisplayable()
,
Window.removeNotify()
public boolean isModal()
此方法已过时,保留它只是为了后向兼容。可以使用 getModalityType()
代替。
true
;否则返回 false
DEFAULT_MODALITY_TYPE
,
Dialog.ModalityType.MODELESS
,
setModal(boolean)
,
getModalityType()
,
setModalityType(java.awt.Dialog.ModalityType)
public void setModal(boolean modal)
此方法已过时,保留它只是为了后向兼容。可以使用 setModalityType()
代替。
注:更改可见 dialog 的模式只在隐藏该 dialog 并再次显示它时产生效果。
modal
- 指定 dialog 是否阻止在显示的时候将内容输入其他窗口;调用 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)
public Dialog.ModalityType getModalityType()
setModalityType(java.awt.Dialog.ModalityType)
public void setModalityType(Dialog.ModalityType type)
ModalityType
。
如果给定模式类型不受支持,则使用 MODELESS
。您可能想在调用此方法之后调用 getModalityType()
,以确保模式类型已被设置。
注:更改可见 dialog 的模式只在隐藏该 dialog 并再次显示它时产生效果。
type
- 指定 dialog 是否阻止在显示的时候将内容输入其他窗口。null
值和不受支持的模式类型等效于 MODELESS
SecurityException
- 如果调用线程没有使用给定 modalityType
创建有模式 dialog 的权限getModalityType()
,
Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)
public String getTitle()
null
。setTitle(java.lang.String)
public void setTitle(String title)
title
- 显示在 dialog 的边界中的标题;null 值会导致一个空标题getTitle()
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()
@Deprecated public void show()
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)
@Deprecated public void hide()
setVisible(boolean)
取代。
show
(如果它目前受阻塞)。
Window
中的 hide
Window.show()
,
Window.dispose()
,
Window.setVisible(boolean)
public void toBack()
在此虚拟机中,将此窗口放在堆栈顺序的底部,并在其他所有窗口之后显示此窗口。如果此窗口不可见,则不发生任何操作。有些平台不允许其他窗口拥有的窗口出现在其所有者下方。将进行所有尝试来移动此窗口,使其位于堆栈顺序中尽可能靠后的位置;不过,开发人员不应假定此方法在所有情况下都可以将此窗口移到所有其他窗口之下。
由于本机窗口系统多种多样,因此无法保证对焦点窗口和活动窗口的更改能够实现。在此窗口接收 WINDOW_LOST_FOCUS 或 WINDOW_DEACTIVATED 事件之前,开发人员不得假定此窗口不再是焦点窗口或活动窗口。在顶层窗口为焦点窗口的平台上,此方法可能导致此窗口不再是焦点状态。在此情况下,此虚拟机中紧跟其后的可作为焦点的窗口将成为焦点窗口。在堆栈顺序通常不影响焦点窗口的平台上,此方法可能维持焦点窗口和活动窗口不变。
如果此 dialog 是有模式的并且阻止某些窗口,则所有 dialog 都被发送回来,使它们位于正受阻塞的 dialog 下。
Window
中的 toBack
Window.toBack()
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. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。