©
Ce document utilise Manuel du site Web PHP chinois Libérer
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.awt.Component java.awt.Container java.awt.Window java.awt.Dialog javax.swing.JDialog
public class JDialog
创建对话框窗口的主要类。可以使用此类创建自定义的对话框,或者调用 JOptionPane
中的多个类方法来创建各种标准对话框。有关创建对话框的信息,请参阅 The Java Tutorial 中的 How to Make Dialogs 一节。
JDialog
组件包含一个 JRootPane
作为其唯一子组件。contentPane
应该是所有 JDialog
子组件的父级。为了方便使用 add
及其变体,已经重写了 remove
和 setLayout
,以在必要时将其转发到 contentPane
。这意味着可以编写:
dialog.add(child);将子级添加到 contentPane。
contentPane
始终是非 null
的。试图将其设置为 null
会生成异常。默认的 contentPane
有一个 BorderLayout
管理器。有关添加、移除和设置 JDialog
的 LayoutManager
的更多信息,请参阅 RootPaneContainer
。
有关 contentPane
、glassPane
和 layeredPane
组件的完整描述,请参阅 JRootPane
文档。
在多屏幕环境中,可以在不同于其所有者的屏幕设备上创建一个 JDialog
。有关更多信息,请参阅 Frame
。
警告:Swing 不是线程安全的。有关更多信息,请参阅 Swing's Threading Policy。
警告:此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储,或适用于在运行相同 Swing 版本的应用程序之间进行 RMI(Remote Method Invocation,远程方法调用)。从 1.4 版本开始,已在 java.beans
包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 XMLEncoder
。
JOptionPane
,
JRootPane
,
RootPaneContainer
嵌套类摘要 | |
---|---|
protected class |
JDialog.AccessibleJDialog
此类实现对 JDialog 类的可访问性支持。 |
从类 java.awt.Dialog 继承的嵌套类/接口 |
---|
Dialog.AccessibleAWTDialog, Dialog.ModalExclusionType, Dialog.ModalityType |
从类 java.awt.Window 继承的嵌套类/接口 |
---|
Window.AccessibleAWTWindow |
从类 java.awt.Container 继承的嵌套类/接口 |
---|
Container.AccessibleAWTContainer |
从类 java.awt.Component 继承的嵌套类/接口 |
---|
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy |
字段摘要 | |
---|---|
protected AccessibleContext |
accessibleContext
|
protected JRootPane |
rootPane
|
protected boolean |
rootPaneCheckingEnabled
如果为 true,则将对 add 和 setLayout 的调用转发到 contentPane 。 |
从类 java.awt.Dialog 继承的字段 |
---|
DEFAULT_MODALITY_TYPE |
从类 java.awt.Component 继承的字段 |
---|
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT |
从接口 javax.swing.WindowConstants 继承的字段 |
---|
DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE |
从接口 java.awt.image.ImageObserver 继承的字段 |
---|
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
构造方法摘要 | |
---|---|
JDialog()
创建一个没有标题并且没有指定 Frame 所有者的无模式对话框。 |
|
JDialog(Dialog owner)
创建一个没有标题但将指定的 Dialog 作为其所有者的无模式对话框。 |
|
JDialog(Dialog owner,
boolean modal)
创建一个具有指定所有者 Dialog 和模式的对话框。 |
|
JDialog(Dialog owner,
String title)
创建一个具有指定标题和指定所有者对话框的无模式对话框。 |
|
JDialog(Dialog owner,
String title,
boolean modal)
创建一个具有指定标题、模式和指定所有者 Dialog 的对话框。 |
|
JDialog(Dialog owner,
String title,
boolean modal,
GraphicsConfiguration gc)
创建一个具有指定标题、所有者 Dialog 、模式和 GraphicsConfiguration 的对话框。 |
|
JDialog(Frame owner)
创建一个没有标题但将指定的 Frame 作为其所有者的无模式对话框。 |
|
JDialog(Frame owner,
boolean modal)
创建一个具有指定所有者 Frame 、模式和空标题的对话框。 |
|
JDialog(Frame owner,
String title)
创建一个具有指定标题和指定所有者窗体的无模式对话框。 |
|
JDialog(Frame owner,
String title,
boolean modal)
创建一个具有指定标题、所有者 Frame 和模式的对话框。 |
|
JDialog(Frame owner,
String title,
boolean modal,
GraphicsConfiguration gc)
创建一个具有指定标题、所有者 Frame 、模式和 GraphicsConfiguration 的对话框。 |
|
JDialog(Window owner)
创建一个具有指定所有者 Window 和空标题的无模式对话框。 |
|
JDialog(Window owner,
Dialog.ModalityType modalityType)
创建一个具有指定所有者 Window 、模式和空标题的对话框。 |
|
JDialog(Window owner,
String title)
创建一个具有指定标题和所有者 Window 的无模式对话框。 |
|
JDialog(Window owner,
String title,
Dialog.ModalityType modalityType)
创建一个具有指定标题、所有者 Window 和模式的对话框。 |
|
JDialog(Window owner,
String title,
Dialog.ModalityType modalityType,
GraphicsConfiguration gc)
创建一个具有指定标题、所有者 Window 、模式和 GraphicsConfiguration 的对话框。 |
方法摘要 | |
---|---|
protected void |
addImpl(Component comp,
Object constraints,
int index)
添加指定的子 Component 。 |
protected JRootPane |
createRootPane()
构造方法调用此方法来创建默认的 rootPane 。 |
protected void |
dialogInit()
构造方法调用此方法来正确初始化 JDialog 。 |
AccessibleContext |
getAccessibleContext()
获取与此 JDialog 关联的 AccessibleContext。 |
Container |
getContentPane()
返回此对话框的 contentPane 对象。 |
int |
getDefaultCloseOperation()
返回用户在此对话框上启动 "close" 时所执行的操作。 |
Component |
getGlassPane()
返回此对话框的 glassPane 对象。 |
Graphics |
getGraphics()
为组件创建一个图形上下文。 |
JMenuBar |
getJMenuBar()
返回此对话框上设置的菜单栏。 |
JLayeredPane |
getLayeredPane()
返回此对话框的 layeredPane 对象。 |
JRootPane |
getRootPane()
返回此对话框的 rootPane 对象。 |
TransferHandler |
getTransferHandler()
获取 transferHandler 属性。 |
static boolean |
isDefaultLookAndFeelDecorated()
如果应该通过当前外观为新创建的 JDialog 提供其 Window 装饰,则返回 true。 |
protected boolean |
isRootPaneCheckingEnabled()
返回是否将对 add 和 setLayout 的调用转发到 contentPane 。 |
protected String |
paramString()
返回此 JDialog 的字符串表示形式。 |
protected void |
processWindowEvent(WindowEvent e)
根据 defaultCloseOperation 属性的状态处理窗口事件。 |
void |
remove(Component comp)
从该容器中移除指定组件。 |
void |
repaint(long time,
int x,
int y,
int width,
int height)
在 time 毫秒内重绘此组件的指定矩形区域。 |
void |
setContentPane(Container contentPane)
设置 contentPane 属性。 |
void |
setDefaultCloseOperation(int operation)
设置当用户在此对话框上启动 "close" 时默认执行的操作。 |
static void |
setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated)
提供一个关于是否应该通过当前外观为新创建的 JDialog 提供其 Window 装饰(如边界、关闭窗口的小部件、标题……)的提示。 |
void |
setGlassPane(Component glassPane)
设置 glassPane 属性。 |
void |
setJMenuBar(JMenuBar menu)
设置此对话框的菜单栏。 |
void |
setLayeredPane(JLayeredPane layeredPane)
设置 layeredPane 属性。 |
void |
setLayout(LayoutManager manager)
设置 LayoutManager 。 |
protected void |
setRootPane(JRootPane root)
设置 rootPane 属性。 |
protected void |
setRootPaneCheckingEnabled(boolean enabled)
设置是否将对 add 和 setLayout 的调用转发到 contentPane 。 |
void |
setTransferHandler(TransferHandler newHandler)
设置 transferHandler 属性,该属性是支持向此组件传输数据的机制。 |
void |
update(Graphics g)
调用 paint(g) 。 |
从类 java.awt.Dialog 继承的方法 |
---|
addNotify, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setModal, setModalityType, setResizable, setTitle, setUndecorated, setVisible, show, 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, 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, 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, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusBackward, transferFocusDownCycle, 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, 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, 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 |
字段详细信息 |
---|
protected JRootPane rootPane
getRootPane()
,
setRootPane(javax.swing.JRootPane)
protected boolean rootPaneCheckingEnabled
add
和 setLayout
的调用转发到 contentPane
。此方法初始为 false,但在构造 JDialog
时将其设置为 true。
isRootPaneCheckingEnabled()
,
setRootPaneCheckingEnabled(boolean)
,
RootPaneContainer
protected AccessibleContext accessibleContext
构造方法详细信息 |
---|
public JDialog()
Frame
所有者的无模式对话框。一个共享的、隐藏的窗体将被设置为该对话框的所有者。
此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale
所返回的值。
注:此构造方法不允许创建没有所有者的 JDialog
。要创建没有所有者的 JDialog
,必须使用带有 null
参数的 JDialog(Window)
或 JDialog(Dialog)
构造方法。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless()
返回 true
。GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Frame owner)
Frame
作为其所有者的无模式对话框。如果 owner
为 null
,则一个共享的、隐藏的窗体将被设置为该对话框的所有者。
此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale
所返回的值。
注:此构造方法不允许创建没有所有者的 JDialog
。要创建没有所有者的 JDialog
,必须使用带有 null
参数的 JDialog(Window)
或 JDialog(Dialog)
构造方法。
owner
- 显示该对话框的 Frame
HeadlessException
- 如果 GraphicsEnvironment.isHeadless()
返回 true
。GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Frame owner, boolean modal)
Frame
、模式和空标题的对话框。如果 owner
为 null
,则一个共享的、隐藏的窗体将被设置为该对话框的所有者。
此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale
所返回的值。
注:此构造方法不允许创建没有所有者的 JDialog
。要创建没有所有者的 JDialog
,必须使用带有 null
参数的 JDialog(Window)
或 JDialog(Dialog)
构造方法。
owner
- 显示该对话框的 Frame
modal
- 指定对话框在显示时是否阻塞用户向其他顶层窗口输入。如果为 true
,则模式类型属性被设置为 DEFAULT_MODALITY_TYPE
;否则对话框是无模式
HeadlessException
- 如果 GraphicsEnvironment.isHeadless()
返回 true
。GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Frame owner, String title)
owner
为 null
,则一个共享的、隐藏的窗体将被设置为该对话框的所有者。
此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale
所返回的值。
注:此构造方法不允许创建没有所有者的 JDialog
。要创建没有所有者的 JDialog
,必须使用带有 null
参数的 JDialog(Window)
或 JDialog(Dialog)
构造方法。
owner
- 显示该对话框的 Frame
title
- 该对话框的标题栏中所显示的 String
HeadlessException
- 如果 GraphicsEnvironment.isHeadless()
返回 true
。GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Frame owner, String title, boolean modal)
Frame
和模式的对话框。如果 owner
为 null
,则一个共享的、隐藏的窗体将被设置为该对话框的所有者。
此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale
所返回的值。
注:强制要求在有模式对话框中所创建的所有弹出式组件(JComboBox
、JPopupMenu
、JMenuBar
)都是轻量级的。
注:此构造方法不允许创建没有所有者的 JDialog
。要创建没有所有者的 JDialog
,必须使用带有 null
参数的 JDialog(Window)
或 JDialog(Dialog)
构造方法。
owner
- 显示该对话框的 Frame
title
- 该对话框的标题栏中所显示的 String
modal
- 指定对话框在显示时是否阻塞用户向其他顶层窗口输入。如果为 true
,则模式类型属性被设置为 DEFAULT_MODALITY_TYPE
;否则对话框是无模式的。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless()
返回 true
。Dialog.ModalityType
,
Dialog.ModalityType.MODELESS
,
Dialog.DEFAULT_MODALITY_TYPE
,
Dialog.setModal(boolean)
,
Dialog.setModalityType(java.awt.Dialog.ModalityType)
,
GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Frame owner, String title, boolean modal, GraphicsConfiguration gc)
Frame
、模式和 GraphicsConfiguration
的对话框。如果 owner
为 null
,则一个共享的、隐藏的窗体将被设置为该对话框的所有者。
此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale
返回的值。
注:强制要求在有模式对话框中所创建的所有弹出式组件(JComboBox
、JPopupMenu
、JMenuBar
)都是轻量级的。
注:此构造方法不允许创建没有所有者的 JDialog
。要创建没有所有者的 JDialog
,必须使用带有 null
参数的 JDialog(Window)
或 JDialog(Dialog)
构造方法。
owner
- 显示该对话框的 Frame
title
- 该对话框的标题栏中所显示的 String
modal
- 指定对话框在显示时是否阻塞用户向其他顶层窗口输入。如果为 true
,则模式类型属性被设置为 DEFAULT_MODALITY_TYPE
;否则对话框是无模式的。gc
- 目标屏幕设备的 GraphicsConfiguration
。如果 gc
为 null
,则使用与 Frame 相同的 GraphicsConfiguration
。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless()
返回 true
。Dialog.ModalityType
,
Dialog.ModalityType.MODELESS
,
Dialog.DEFAULT_MODALITY_TYPE
,
Dialog.setModal(boolean)
,
Dialog.setModalityType(java.awt.Dialog.ModalityType)
,
GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Dialog owner)
Dialog
作为其所有者的无模式对话框。
此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale
所返回的值。
owner
- 显示该对话框的所有者 Dialog
;如果此对话框没有所有者,则为 null
HeadlessException
- 如果 GraphicsEnvironment.isHeadless()
返回 true
。GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Dialog owner, boolean modal)
Dialog
和模式的对话框。
此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale
所返回的值。
owner
- 显示该对话框的所有者 Dialog
;如果此对话框没有所有者,则为 null
modal
- 指定对话框在显示时是否阻塞用户向其他顶层窗口输入。如果为 true
,则模式类型属性被设置为 DEFAULT_MODALITY_TYPE
;否则对话框是无模式的。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless()
返回 true
。Dialog.ModalityType
,
Dialog.ModalityType.MODELESS
,
Dialog.DEFAULT_MODALITY_TYPE
,
Dialog.setModal(boolean)
,
Dialog.setModalityType(java.awt.Dialog.ModalityType)
,
GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Dialog owner, String title)
此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale
所返回的值。
owner
- 显示该对话框的所有者 Dialog
;如果此对话框没有所有者,则为 null
title
- 该对话框的标题栏中所显示的 String
HeadlessException
- 如果 GraphicsEnvironment.isHeadless()
返回 true
。GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Dialog owner, String title, boolean modal)
Dialog
的对话框。
此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale
所返回的值。
owner
- 显示该对话框的所有者 Dialog
;如果此对话框没有所有者,则为 null
title
- 该对话框的标题栏中所显示的 String
modal
- 指定对话框在显示时是否阻塞用户向其他顶层窗口输入。如果为 true
,则模式类型属性被设置为 DEFAULT_MODALITY_TYPE
;否则对话框是无模式的。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless()
返回 true
。Dialog.ModalityType
,
Dialog.ModalityType.MODELESS
,
Dialog.DEFAULT_MODALITY_TYPE
,
Dialog.setModal(boolean)
,
Dialog.setModalityType(java.awt.Dialog.ModalityType)
,
GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Dialog owner, String title, boolean modal, GraphicsConfiguration gc)
Dialog
、模式和 GraphicsConfiguration
的对话框。
注:强制要求在有模式对话框中所创建的所有弹出式组件(JComboBox
、JPopupMenu
、JMenuBar
)都是轻量级的。
此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale
所返回的值。
owner
- 显示该对话框的所有者 Dialog
;如果此对话框没有所有者,则为 null
title
- 该对话框的标题栏中所显示的 String
modal
- 指定对话框在显示时是否阻塞用户向其他顶层窗口输入。如果为 true
,则模式类型属性被设置为 DEFAULT_MODALITY_TYPE
;否则对话框是无模式的。gc
- 目标屏幕设备的 GraphicsConfiguration
。如果 gc
为 null
,则使用与 Dialog 相同的 GraphicsConfiguration
。
HeadlessException
- 如果 GraphicsEnvironment.isHeadless()
返回 true
。Dialog.ModalityType
,
Dialog.ModalityType.MODELESS
,
Dialog.DEFAULT_MODALITY_TYPE
,
Dialog.setModal(boolean)
,
Dialog.setModalityType(java.awt.Dialog.ModalityType)
,
GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Window owner)
Window
和空标题的无模式对话框。
此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale
所返回的值。
owner
- 显示该对话框的 Window
;如果此对话框没有所有者,则为 null
HeadlessException
- 当 GraphicsEnvironment.isHeadless()
返回 true
时GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Window owner, Dialog.ModalityType modalityType)
Window
、模式和空标题的对话框。
此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale
所返回的值。
owner
- 显示该对话框的 Window
;如果此对话框没有所有者,则为 null
modalityType
- 指定对话框在显示时是否阻塞向其他窗口输入。null
值和不受支持的模式类型等效于 MODELESS
HeadlessException
- 当 GraphicsEnvironment.isHeadless()
返回 true
时Dialog.ModalityType
,
Dialog.setModal(boolean)
,
Dialog.setModalityType(java.awt.Dialog.ModalityType)
,
GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Window owner, String title)
Window
的无模式对话框。
此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale
所返回的值。
owner
- 显示该对话框的 Window
;如果此对话框没有所有者,则为 null
title
- 该对话框的标题栏中所显示的 String
;如果该对话框没有标题,则为 null
HeadlessException
- 当 GraphicsEnvironment.isHeadless()
返回 true
时GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Window owner, String title, Dialog.ModalityType modalityType)
Window
和模式的对话框。
此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale
所返回的值。
owner
- 显示该对话框的 Window
;如果此对话框没有所有者,则为 null
title
- 该对话框的标题栏中所显示的 String
;如果该对话框没有标题,则为 null
modalityType
- 指定对话框在显示时是否阻塞向其他窗口输入。null
值和不受支持的模式类型等效于 MODELESS
HeadlessException
- 当 GraphicsEnvironment.isHeadless()
返回 true
时Dialog.ModalityType
,
Dialog.setModal(boolean)
,
Dialog.setModalityType(java.awt.Dialog.ModalityType)
,
GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
public JDialog(Window owner, String title, Dialog.ModalityType modalityType, GraphicsConfiguration gc)
Window
、模式和 GraphicsConfiguration
的对话框。
注:强制要求在有模式对话框中所创建的所有弹出式组件(JComboBox
、JPopupMenu
、JMenuBar
)都是轻量级的。
此构造方法将该组件的语言环境属性设置为 JComponent.getDefaultLocale
所返回的值。
owner
- 显示该对话框的 Window
;如果此对话框没有所有者,则为 null
title
- 该对话框的标题栏中所显示的 String
;如果该对话框没有标题,则为 null
modalityType
- 指定对话框在显示时是否阻塞向其他窗口输入。null
值和不受支持的模式类型等效于 MODELESS
gc
- 目标屏幕设备的 GraphicsConfiguration
;如果为 null
,则使用拥有窗口的 GraphicsConfiguration
;如果 owner
也为 null
,则假定它为系统默认的 GraphicsConfiguration
HeadlessException
- 当 GraphicsEnvironment.isHeadless()
返回 true
时Dialog.ModalityType
,
Dialog.setModal(boolean)
,
Dialog.setModalityType(java.awt.Dialog.ModalityType)
,
GraphicsEnvironment.isHeadless()
,
JComponent.getDefaultLocale()
方法详细信息 |
---|
protected void dialogInit()
JDialog
。
protected JRootPane createRootPane()
rootPane
。
protected void processWindowEvent(WindowEvent e)
defaultCloseOperation
属性的状态处理窗口事件。
Window
中的 processWindowEvent
e
- 窗口事件setDefaultCloseOperation(int)
public void setDefaultCloseOperation(int operation)
DO_NOTHING_ON_CLOSE
(在 WindowConstants
中定义):不执行任何操作;需要程序在已注册的 WindowListener
对象的 windowClosing
方法中处理该操作。
HIDE_ON_CLOSE
(在 WindowConstants
中定义):调用任意已注册的 WindowListener
对象后自动隐藏该对话框。
DISPOSE_ON_CLOSE
(WindowConstants
中定义的):调用任意已注册的 WindowListener
对象后自动隐藏并处置该对话框。
默认将该值设置为 HIDE_ON_CLOSE
。对此属性的值的更改将导致触发属性更改事件,带有属性名称 "defaultCloseOperation"。
注:当 Java 虚拟机 (VM) 中最后的可显示窗口被移除后,虚拟机可能会终止。有关更多信息,请参阅 AWT Threading Issues。
operation
- 当用户关闭该对话框时应该执行的操作
IllegalArgumentException
- 如果 defaultCloseOperation 值不是上述有效值之一Window.addWindowListener(java.awt.event.WindowListener)
,
getDefaultCloseOperation()
,
WindowConstants
public int getDefaultCloseOperation()
setDefaultCloseOperation(int)
public void setTransferHandler(TransferHandler newHandler)
transferHandler
属性,该属性是支持向此组件传输数据的机制。如果该组件不支持数据传输操作,那么请使用 null
。
如果系统属性 suppressSwingDropSupport
为 false
(默认值),并且此组件上的当前放置目标为 null
或者不是用户设置的放置目标,则此方法将按如下方式更改放置目标:如果 newHandler
为 null
,则它将清除放置目标。如果不为 null
,则它将安装一个新的 DropTarget
。
注:当用于 JDialog
时,TransferHandler
只提供数据导入功能,与数据导出有关的方法当前用于 JComponent
。
有关更多信息,请参阅 The Java Tutorial 中的 How to Use Drag and Drop and Data Transfer 一节。
newHandler
- 新的 TransferHandler
TransferHandler
,
getTransferHandler()
,
Component.setDropTarget(java.awt.dnd.DropTarget)
public TransferHandler getTransferHandler()
transferHandler
属性。
transferHandler
属性的值TransferHandler
,
setTransferHandler(javax.swing.TransferHandler)
public void update(Graphics g)
paint(g)
。重写此方法,以防止不必要的清除背景调用。
Container
中的 update
g
- 在其中进行绘制的 Graphics
上下文Component.update(Graphics)
public void setJMenuBar(JMenuBar menu)
menu
- 该对话框中放置的菜单栏getJMenuBar()
public JMenuBar getJMenuBar()
setJMenuBar(javax.swing.JMenuBar)
protected boolean isRootPaneCheckingEnabled()
add
和 setLayout
的调用转发到 contentPane
。
add
和 setLayout
,则返回 true;否则返回 falseaddImpl(java.awt.Component, java.lang.Object, int)
,
setLayout(java.awt.LayoutManager)
,
setRootPaneCheckingEnabled(boolean)
,
RootPaneContainer
protected void setRootPaneCheckingEnabled(boolean enabled)
add
和 setLayout
的调用转发到 contentPane
。
enabled
- 如果转发 add
和 setLayout
,则为 true;如果应该直接在 JDialog
上操作,则为 false。addImpl(java.awt.Component, java.lang.Object, int)
,
setLayout(java.awt.LayoutManager)
,
isRootPaneCheckingEnabled()
,
RootPaneContainer
protected void addImpl(Component comp, Object constraints, int index)
Component
。重写此方法,以有条件地将调用转发到 contentPane
。默认情况下将子组件添加到 contentPane
,而不是窗体中,有关此内容的详情,请参阅 RootPaneContainer
。
Container
中的 addImpl
comp
- 要增强的组件constraints
- 要遵守的约束条件index
- 索引
IllegalArgumentException
- 如果 index
无效
IllegalArgumentException
- 如果将容器的父级添加到其本身
IllegalArgumentException
- 如果向容器内添加窗口setRootPaneCheckingEnabled(boolean)
,
RootPaneContainer
public void remove(Component comp)
comp
不是 rootPane
,则将该调用转发到 contentPane
。如果 comp
不是 JDialog
或 contentPane
的子级,则不执行任何操作。
Container
中的 remove
comp
- 要移除的组件
NullPointerException
- 如果 comp
为 nullContainer.add(java.awt.Component)
,
RootPaneContainer
public void setLayout(LayoutManager manager)
LayoutManager
。重写此方法,以有条件地将调用转发到 contentPane
。有关此内容的更多信息,请参阅 RootPaneContainer
。
Container
中的 setLayout
manager
- the LayoutManager
setRootPaneCheckingEnabled(boolean)
,
RootPaneContainer
public JRootPane getRootPane()
rootPane
对象。
RootPaneContainer
中的 getRootPane
setRootPane(javax.swing.JRootPane)
,
RootPaneContainer.getRootPane()
protected void setRootPane(JRootPane root)
rootPane
属性。此方法由构造方法调用。
root
- 此对话框的 rootPane
对象getRootPane()
public Container getContentPane()
contentPane
对象。
RootPaneContainer
中的 getContentPane
contentPane
属性setContentPane(java.awt.Container)
,
RootPaneContainer.getContentPane()
public void setContentPane(Container contentPane)
contentPane
属性。此方法由构造方法调用。
Swing 的绘制架构要求在包含层次结构中有不透明的 JComponent
。这通常由内容窗格提供。如果要替换内容窗格,建议用不透明的 JComponent
替换它。
RootPaneContainer
中的 setContentPane
contentPane
- 此对话框的 contentPane
对象
IllegalComponentStateException
- (运行时异常)如果 contentPane 参数为 null
JRootPane
,
getContentPane()
,
RootPaneContainer.setContentPane(java.awt.Container)
public JLayeredPane getLayeredPane()
layeredPane
对象。
RootPaneContainer
中的 getLayeredPane
layeredPane
属性setLayeredPane(javax.swing.JLayeredPane)
,
RootPaneContainer.getLayeredPane()
public void setLayeredPane(JLayeredPane layeredPane)
layeredPane
属性。此方法由构造方法调用。
RootPaneContainer
中的 setLayeredPane
layeredPane
- 新的 layeredPane
属性
IllegalComponentStateException
- (运行时异常)如果 layeredPane 参数为 nullgetLayeredPane()
,
RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)
public Component getGlassPane()
glassPane
对象。
RootPaneContainer
中的 getGlassPane
glassPane
属性setGlassPane(java.awt.Component)
,
RootPaneContainer.getGlassPane()
public void setGlassPane(Component glassPane)
glassPane
属性。此方法由构造方法调用。
RootPaneContainer
中的 setGlassPane
glassPane
- 此对话框的 glassPane
对象getGlassPane()
,
RootPaneContainer.setGlassPane(java.awt.Component)
public Graphics getGraphics()
null
。
Component
中的 getGraphics
null
Component.paint(java.awt.Graphics)
public void repaint(long time, int x, int y, int width, int height)
time
毫秒内重绘此组件的指定矩形区域。有关如何处理重绘的详细信息,请参阅 RepaintManager
。
Component
中的 repaint
time
- 更新前等待的最长时间(以毫秒为单位)x
- x 坐标y
- y 坐标width
- 宽度height
- 高度RepaintManager
public static void setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated)
JDialog
提供其 Window 装饰(如边界、关闭窗口的小部件、标题……)的提示。如果 defaultLookAndFeelDecorated
为 true、当前 LookAndFeel
支持提供 Window 装饰,并且当前窗口管理器支持未装饰的窗口,则通过当前 LookAndFeel
为新创建的 JDialog
提供其 Window 装饰。否则,通过当前窗口管理器为新创建的 JDialog
提供其 Window 装饰。
执行下列操作可在单个 JDialog 上获取相同的效果:
JDialog dialog = new JDialog(); dialog.setUndecorated(true); dialog.getRootPane().setWindowDecorationStyle(JRootPane.PLAIN_DIALOG);
defaultLookAndFeelDecorated
- 关于当前外观是否应该提供 window 装饰的提示LookAndFeel.getSupportsWindowDecorations()
public static boolean isDefaultLookAndFeelDecorated()
JDialog
提供其 Window 装饰,则返回 true。这只是一个提示,因为某些外观可能不支持此功能。
protected String paramString()
JDialog
的字符串表示形式。此方法仅在进行调试时使用,对于各个实现,所返回字符串的内容和格式可能有所不同。返回的字符串可以为空,但不可以为 null
。
Dialog
中的 paramString
JDialog
的字符串表示形式。public AccessibleContext getAccessibleContext()
Accessible
中的 getAccessibleContext
Dialog
中的 getAccessibleContext
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。