Dialog (Java 2 Platform SE 5.0) (original) (raw)

java.awt

Class Dialog

java.lang.Object extended by java.awt.Component java.awt.Container java.awt.Window java.awt.Dialog

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible

Direct Known Subclasses:

FileDialog, JDialog

public class Dialog

extends Window

A Dialog is a top-level window with a title and a border that is typically used to take some form of input from the user. The size of the dialog includes any area designated for the border. The dimensions of the border area can be obtained using the getInsets method, however, since these dimensions are platform-dependent, a valid insets value cannot be obtained until the dialog is made displayable by either calling pack or show. Since the border area is included in the overall size of the dialog, the border effectively obscures a portion of the dialog, constraining the area available for rendering and/or displaying subcomponents to the rectangle which has an upper-left corner location of (insets.left, insets.top), and has a size ofwidth - (insets.left + insets.right) by height - (insets.top + insets.bottom).

The default layout for a dialog is BorderLayout.

A dialog may have its native decorations (i.e. Frame & Titlebar) turned off with setUndecorated. This can only be done while the dialog is not displayable.

A dialog must have either a frame or another dialog defined as its owner when it's constructed. When the owner window of a visible dialog is minimized, the dialog will automatically be hidden from the user. When the owner window is subsequently restored, the dialog is made visible to the user again.

In a multi-screen environment, you can create a Dialog on a different screen device than its owner. See Frame for more information.

A dialog can be either modeless (the default) or modal. A modal dialog is one which blocks input to all other toplevel windows in the application, except for any windows created with the dialog as their owner.

Dialogs are capable of generating the followingWindowEvents:WindowOpened, WindowClosing,WindowClosed, WindowActivated,WindowDeactivated, WindowGainedFocus,WindowLostFocus.

Since:

JDK1.0

Nested Class Summary
protected class	Dialog.AccessibleAWTDialog This class implements accessibility support for the Dialog class.

Nested classes/interfaces inherited from class java.awt.Window
Window.AccessibleAWTWindow

Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary
Dialog(Dialog owner) Constructs an initially invisible, non-modal Dialog with an empty title and the specified owner dialog.
[Dialog](../../java/awt/Dialog.html#Dialog%28java.awt.Dialog, java.lang.String%29)(Dialog owner,String title) Constructs an initially invisible, non-modal Dialog with the specified owner dialog and title.
[Dialog](../../java/awt/Dialog.html#Dialog%28java.awt.Dialog, java.lang.String, boolean%29)(Dialog owner,String title, boolean modal) Constructs an initially invisible Dialog with the specified owner dialog, title, and modality.
[Dialog](../../java/awt/Dialog.html#Dialog%28java.awt.Dialog, java.lang.String, boolean, java.awt.GraphicsConfiguration%29)(Dialog owner,String title, boolean modal,GraphicsConfiguration gc) Constructs an initially invisible Dialog with the specified owner dialog, title, modality, andGraphicsConfiguration.
Dialog(Frame owner) Constructs an initially invisible, non-modal Dialog with an empty title and the specified owner frame.
[Dialog](../../java/awt/Dialog.html#Dialog%28java.awt.Frame, boolean%29)(Frame owner, boolean modal) Constructs an initially invisible Dialog with an empty title, the specified owner frame and modality.
[Dialog](../../java/awt/Dialog.html#Dialog%28java.awt.Frame, java.lang.String%29)(Frame owner,String title) Constructs an initially invisible, non-modal Dialog with the specified owner frame and title.
[Dialog](../../java/awt/Dialog.html#Dialog%28java.awt.Frame, java.lang.String, boolean%29)(Frame owner,String title, boolean modal) Constructs an initially invisible Dialog with the specified owner frame, title, and modality.
[Dialog](../../java/awt/Dialog.html#Dialog%28java.awt.Frame, java.lang.String, boolean, java.awt.GraphicsConfiguration%29)(Frame owner,String title, boolean modal,GraphicsConfiguration gc) Constructs an initially invisible Dialog with the specified owner frame, title, modality, andGraphicsConfiguration.

Method Summary
void	addNotify() Makes this Dialog displayable by connecting it to a native screen resource.
AccessibleContext	getAccessibleContext() Gets the AccessibleContext associated with this Dialog.
String	getTitle() Gets the title of the dialog.
void	hide() Deprecated. As of JDK version 1.5, replaced byComponent.setVisible(boolean).
boolean	isModal() Indicates whether the dialog is modal.
boolean	isResizable() Indicates whether this dialog is resizable by the user.
boolean	isUndecorated() Indicates whether this dialog is undecorated.
protected String	paramString() Returns a string representing the state of this dialog.
void	setModal(boolean b) Specifies whether this dialog should be modal.
void	setResizable(boolean resizable) Sets whether this dialog is resizable by the user.
void	setTitle(String title) Sets the title of the Dialog.
void	setUndecorated(boolean undecorated) Disables or enables decorations for this dialog.
void	show() Deprecated. As of JDK version 1.5, replaced byComponent.setVisible(boolean).

Methods inherited from class java.awt.Window
addPropertyChangeListener, [addPropertyChangeListener](../../java/awt/Window.html#addPropertyChangeListener%28java.lang.String, java.beans.PropertyChangeListener%29), addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, [createBufferStrategy](../../java/awt/Window.html#createBufferStrategy%28int, java.awt.BufferCapabilities%29), 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](../../java/awt/Window.html#setBounds%28int, int, int, int%29), setCursor, setFocusableWindowState, setFocusCycleRoot, setLocationByPlatform, setLocationRelativeTo, toBack, toFront

Methods inherited from class java.awt.Window

addPropertyChangeListener, [addPropertyChangeListener](../../java/awt/Window.html#addPropertyChangeListener%28java.lang.String, java.beans.PropertyChangeListener%29), addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, [createBufferStrategy](../../java/awt/Window.html#createBufferStrategy%28int, java.awt.BufferCapabilities%29), 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](../../java/awt/Window.html#setBounds%28int, int, int, int%29), setCursor, setFocusableWindowState, setFocusCycleRoot, setLocationByPlatform, setLocationRelativeTo, toBack, toFront

Methods inherited from class java.awt.Container
add, [add](../../java/awt/Container.html#add%28java.awt.Component, int%29), [add](../../java/awt/Container.html#add%28java.awt.Component, java.lang.Object%29), [add](../../java/awt/Container.html#add%28java.awt.Component, java.lang.Object, int%29), [add](../../java/awt/Container.html#add%28java.lang.String, java.awt.Component%29), addContainerListener, [addImpl](../../java/awt/Container.html#addImpl%28java.awt.Component, java.lang.Object, int%29), applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, [findComponentAt](../../java/awt/Container.html#findComponentAt%28int, int%29), findComponentAt, getAlignmentX, getAlignmentY, getComponent, [getComponentAt](../../java/awt/Container.html#getComponentAt%28int, int%29), getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, [list](../../java/awt/Container.html#list%28java.io.PrintStream, int%29), [list](../../java/awt/Container.html#list%28java.io.PrintWriter, int%29), [locate](../../java/awt/Container.html#locate%28int, int%29), minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, removeNotify, [setComponentZOrder](../../java/awt/Container.html#setComponentZOrder%28java.awt.Component, int%29), [setFocusTraversalKeys](../../java/awt/Container.html#setFocusTraversalKeys%28int, java.util.Set%29), setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusBackward, transferFocusDownCycle, update, validate, validateTree

Methods inherited from class java.awt.Container

add, [add](../../java/awt/Container.html#add%28java.awt.Component, int%29), [add](../../java/awt/Container.html#add%28java.awt.Component, java.lang.Object%29), [add](../../java/awt/Container.html#add%28java.awt.Component, java.lang.Object, int%29), [add](../../java/awt/Container.html#add%28java.lang.String, java.awt.Component%29), addContainerListener, [addImpl](../../java/awt/Container.html#addImpl%28java.awt.Component, java.lang.Object, int%29), applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, [findComponentAt](../../java/awt/Container.html#findComponentAt%28int, int%29), findComponentAt, getAlignmentX, getAlignmentY, getComponent, [getComponentAt](../../java/awt/Container.html#getComponentAt%28int, int%29), getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, [list](../../java/awt/Container.html#list%28java.io.PrintStream, int%29), [list](../../java/awt/Container.html#list%28java.io.PrintWriter, int%29), [locate](../../java/awt/Container.html#locate%28int, int%29), minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, removeNotify, [setComponentZOrder](../../java/awt/Container.html#setComponentZOrder%28java.awt.Component, int%29), [setFocusTraversalKeys](../../java/awt/Container.html#setFocusTraversalKeys%28int, java.util.Set%29), setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusBackward, transferFocusDownCycle, update, validate, validateTree

Methods inherited from class java.awt.Component
[action](../../java/awt/Component.html#action%28java.awt.Event, java.lang.Object%29), add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, [checkImage](../../java/awt/Component.html#checkImage%28java.awt.Image, java.awt.image.ImageObserver%29), [checkImage](../../java/awt/Component.html#checkImage%28java.awt.Image, int, int, java.awt.image.ImageObserver%29), [coalesceEvents](../../java/awt/Component.html#coalesceEvents%28java.awt.AWTEvent, java.awt.AWTEvent%29), [contains](../../java/awt/Component.html#contains%28int, int%29), contains, createImage, [createImage](../../java/awt/Component.html#createImage%28int, int%29), [createVolatileImage](../../java/awt/Component.html#createVolatileImage%28int, int%29), [createVolatileImage](../../java/awt/Component.html#createVolatileImage%28int, int, java.awt.ImageCapabilities%29), disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String, boolean, boolean%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String, byte, byte%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String, char, char%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String, double, double%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String, float, float%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String, int, int%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String, long, long%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String, java.lang.Object, java.lang.Object%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String, short, short%29), 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](../../java/awt/Component.html#gotFocus%28java.awt.Event, java.lang.Object%29), handleEvent, hasFocus, [imageUpdate](../../java/awt/Component.html#imageUpdate%28java.awt.Image, int, int, int, int, int%29), [inside](../../java/awt/Component.html#inside%28int, int%29), isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isValid, isVisible, [keyDown](../../java/awt/Component.html#keyDown%28java.awt.Event, int%29), [keyUp](../../java/awt/Component.html#keyUp%28java.awt.Event, int%29), list, list, list, location, [lostFocus](../../java/awt/Component.html#lostFocus%28java.awt.Event, java.lang.Object%29), [mouseDown](../../java/awt/Component.html#mouseDown%28java.awt.Event, int, int%29), [mouseDrag](../../java/awt/Component.html#mouseDrag%28java.awt.Event, int, int%29), [mouseEnter](../../java/awt/Component.html#mouseEnter%28java.awt.Event, int, int%29), [mouseExit](../../java/awt/Component.html#mouseExit%28java.awt.Event, int, int%29), [mouseMove](../../java/awt/Component.html#mouseMove%28java.awt.Event, int, int%29), [mouseUp](../../java/awt/Component.html#mouseUp%28java.awt.Event, int, int%29), [move](../../java/awt/Component.html#move%28int, int%29), nextFocus, paintAll, [prepareImage](../../java/awt/Component.html#prepareImage%28java.awt.Image, java.awt.image.ImageObserver%29), [prepareImage](../../java/awt/Component.html#prepareImage%28java.awt.Image, int, int, java.awt.image.ImageObserver%29), printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, [removePropertyChangeListener](../../java/awt/Component.html#removePropertyChangeListener%28java.lang.String, java.beans.PropertyChangeListener%29), repaint, [repaint](../../java/awt/Component.html#repaint%28int, int, int, int%29), repaint, [repaint](../../java/awt/Component.html#repaint%28long, int, int, int, int%29), requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, [reshape](../../java/awt/Component.html#reshape%28int, int, int, int%29), resize, [resize](../../java/awt/Component.html#resize%28int, int%29), setBackground, setBounds, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, [setLocation](../../java/awt/Component.html#setLocation%28int, int%29), setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, [setSize](../../java/awt/Component.html#setSize%28int, int%29), setVisible, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.awt.Component

[action](../../java/awt/Component.html#action%28java.awt.Event, java.lang.Object%29), add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, [checkImage](../../java/awt/Component.html#checkImage%28java.awt.Image, java.awt.image.ImageObserver%29), [checkImage](../../java/awt/Component.html#checkImage%28java.awt.Image, int, int, java.awt.image.ImageObserver%29), [coalesceEvents](../../java/awt/Component.html#coalesceEvents%28java.awt.AWTEvent, java.awt.AWTEvent%29), [contains](../../java/awt/Component.html#contains%28int, int%29), contains, createImage, [createImage](../../java/awt/Component.html#createImage%28int, int%29), [createVolatileImage](../../java/awt/Component.html#createVolatileImage%28int, int%29), [createVolatileImage](../../java/awt/Component.html#createVolatileImage%28int, int, java.awt.ImageCapabilities%29), disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String, boolean, boolean%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String, byte, byte%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String, char, char%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String, double, double%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String, float, float%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String, int, int%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String, long, long%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String, java.lang.Object, java.lang.Object%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String, short, short%29), 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](../../java/awt/Component.html#gotFocus%28java.awt.Event, java.lang.Object%29), handleEvent, hasFocus, [imageUpdate](../../java/awt/Component.html#imageUpdate%28java.awt.Image, int, int, int, int, int%29), [inside](../../java/awt/Component.html#inside%28int, int%29), isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isValid, isVisible, [keyDown](../../java/awt/Component.html#keyDown%28java.awt.Event, int%29), [keyUp](../../java/awt/Component.html#keyUp%28java.awt.Event, int%29), list, list, list, location, [lostFocus](../../java/awt/Component.html#lostFocus%28java.awt.Event, java.lang.Object%29), [mouseDown](../../java/awt/Component.html#mouseDown%28java.awt.Event, int, int%29), [mouseDrag](../../java/awt/Component.html#mouseDrag%28java.awt.Event, int, int%29), [mouseEnter](../../java/awt/Component.html#mouseEnter%28java.awt.Event, int, int%29), [mouseExit](../../java/awt/Component.html#mouseExit%28java.awt.Event, int, int%29), [mouseMove](../../java/awt/Component.html#mouseMove%28java.awt.Event, int, int%29), [mouseUp](../../java/awt/Component.html#mouseUp%28java.awt.Event, int, int%29), [move](../../java/awt/Component.html#move%28int, int%29), nextFocus, paintAll, [prepareImage](../../java/awt/Component.html#prepareImage%28java.awt.Image, java.awt.image.ImageObserver%29), [prepareImage](../../java/awt/Component.html#prepareImage%28java.awt.Image, int, int, java.awt.image.ImageObserver%29), printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, [removePropertyChangeListener](../../java/awt/Component.html#removePropertyChangeListener%28java.lang.String, java.beans.PropertyChangeListener%29), repaint, [repaint](../../java/awt/Component.html#repaint%28int, int, int, int%29), repaint, [repaint](../../java/awt/Component.html#repaint%28long, int, int, int, int%29), requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, [reshape](../../java/awt/Component.html#reshape%28int, int, int, int%29), resize, [resize](../../java/awt/Component.html#resize%28int, int%29), setBackground, setBounds, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, [setLocation](../../java/awt/Component.html#setLocation%28int, int%29), setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, [setSize](../../java/awt/Component.html#setSize%28int, int%29), setVisible, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, [wait](../../java/lang/Object.html#wait%28long, int%29)

Constructor Detail

Dialog

public Dialog(Frame owner)

Constructs an initially invisible, non-modal Dialog with an empty title and the specified owner frame.

Parameters:

owner - the owner of the dialog

Throws:

[IllegalArgumentException](../../java/lang/IllegalArgumentException.html "class in java.lang") - if the owner'sGraphicsConfiguration is not from a screen device

[IllegalArgumentException](../../java/lang/IllegalArgumentException.html "class in java.lang") - if owner is null; this exception is always thrown when GraphicsEnvironment.isHeadless returns true

See Also:

GraphicsEnvironment.isHeadless(), [Component.setSize(int, int)](../../java/awt/Component.html#setSize%28int, int%29), Component.setVisible(boolean)

Dialog

public Dialog(Frame owner, boolean modal)

Constructs an initially invisible Dialog with an empty title, the specified owner frame and modality.

Parameters:

owner - the owner of the dialog

modal - if true, dialog blocks input to other app windows when shown

Throws:

[IllegalArgumentException](../../java/lang/IllegalArgumentException.html "class in java.lang") - if the owner'sGraphicsConfiguration is not from a screen device

See Also:

GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Frame owner, String title)

Constructs an initially invisible, non-modal Dialog with the specified owner frame and title.

Parameters:

owner - the owner of the dialog

title - the title of the dialog; a null value will be accepted without causing aNullPointerException to be thrown

Throws:

[IllegalArgumentException](../../java/lang/IllegalArgumentException.html "class in java.lang") - if the owner'sGraphicsConfiguration is not from a screen device

See Also:

GraphicsEnvironment.isHeadless(), [Component.setSize(int, int)](../../java/awt/Component.html#setSize%28int, int%29), Component.setVisible(boolean)

Dialog

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

Constructs an initially invisible Dialog with the specified owner frame, title, and modality.

Parameters:

owner - the owner of the dialog

title - the title of the dialog; a null value will be accepted without causing aNullPointerException to be thrown

modal - if true, dialog blocks input to other app windows when shown

Throws:

[IllegalArgumentException](../../java/lang/IllegalArgumentException.html "class in java.lang") - if the owner'sGraphicsConfiguration is not from a screen device

[IllegalArgumentException](../../java/lang/IllegalArgumentException.html "class in java.lang") - if owner is null. This exception is always thrown when GraphicsEnvironment.isHeadless returns true

See Also:

GraphicsEnvironment.isHeadless(), [Component.setSize(int, int)](../../java/awt/Component.html#setSize%28int, int%29), Component.setVisible(boolean)

Dialog

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

Constructs an initially invisible Dialog with the specified owner frame, title, modality, andGraphicsConfiguration.

Parameters:

owner - the owner of the dialog

title - the title of the dialog. A null value will be accepted without causing a NullPointerException to be thrown.

modal - if true, dialog blocks input to other app windows when shown

gc - the GraphicsConfiguration of the target screen device. If gc is null, the sameGraphicsConfiguration as the owning Frame is used.

Throws:

[IllegalArgumentException](../../java/lang/IllegalArgumentException.html "class in java.lang") - if owner is null. This exception is always thrown when GraphicsEnvironment.isHeadless() returns true

Since:

1.4

See Also:

GraphicsEnvironment.isHeadless(), [Component.setSize(int, int)](../../java/awt/Component.html#setSize%28int, int%29), Component.setVisible(boolean)

Dialog

public Dialog(Dialog owner)

Constructs an initially invisible, non-modal Dialog with an empty title and the specified owner dialog.

Parameters:

owner - the owner of the dialog

Throws:

Since:

1.2

See Also:

GraphicsEnvironment.isHeadless()

Dialog

public Dialog(Dialog owner, String title)

Constructs an initially invisible, non-modal Dialog with the specified owner dialog and title.

Parameters:

owner - the owner of the dialog

title - the title of the dialog. A null value will be accepted without causing a NullPointerException to be thrown.

Throws:

Since:

1.2

See Also:

GraphicsEnvironment.isHeadless()

Dialog

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

Constructs an initially invisible Dialog with the specified owner dialog, title, and modality.

Parameters:

owner - the owner of the dialog

title - the title of the dialog; a null value will be accepted without causing aNullPointerException to be thrown

modal - if true, dialog blocks input to other app windows when shown

Throws:

[IllegalArgumentException](../../java/lang/IllegalArgumentException.html "class in java.lang") - if the owner'sGraphicsConfiguration is not from a screen device

Since:

1.2

See Also:

GraphicsEnvironment.isHeadless()

Dialog

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

Constructs an initially invisible Dialog with the specified owner dialog, title, modality, andGraphicsConfiguration.

Parameters:

owner - the owner of the dialog

title - the title of the dialog; a null value will be accepted without causing aNullPointerException to be thrown

modal - if true, dialog blocks input to other app windows when shown

gc - the GraphicsConfiguration of the target screen device; if gc is null, the sameGraphicsConfiguration as the owning Dialog is used

Throws:

[IllegalArgumentException](../../java/lang/IllegalArgumentException.html "class in java.lang") - if the owner'sGraphicsConfiguration is not from a screen device

Since:

1.4

See Also:

GraphicsEnvironment.isHeadless(), [Component.setSize(int, int)](../../java/awt/Component.html#setSize%28int, int%29), Component.setVisible(boolean)

Method Detail

addNotify

public void addNotify()

Makes this Dialog displayable by connecting it to a native screen resource. Making a dialog displayable will cause any of its children to be made displayable. This method is called internally by the toolkit and should not be called directly by programs.

Overrides:

[addNotify](../../java/awt/Window.html#addNotify%28%29) in class [Window](../../java/awt/Window.html "class in java.awt")

isModal

public boolean isModal()

Indicates whether the dialog is modal. When a modal Dialog is made visible, user input will be blocked to the other windows in the application, except for any windows created with this dialog as their owner.

Returns:

true if this dialog window is modal;false otherwise.

See Also:

setModal(boolean)

setModal

public void setModal(boolean b)

Specifies whether this dialog should be modal.

Since:

JDK1.1

See Also:

isModal()

getTitle

public String getTitle()

Gets the title of the dialog. The title is displayed in the dialog's border.

Returns:

the title of this dialog window. The title may benull.

See Also:

setTitle(java.lang.String)

setTitle

public void setTitle(String title)

Sets the title of the Dialog.

Parameters:

title - the title displayed in the dialog's border; a null value results in an empty title

See Also:

getTitle()

show

@Deprecated public void show()

Deprecated. As of JDK version 1.5, replaced byComponent.setVisible(boolean).

Overrides:

[show](../../java/awt/Window.html#show%28%29) in class [Window](../../java/awt/Window.html "class in java.awt")

hide

@Deprecated public void hide()

Deprecated. As of JDK version 1.5, replaced byComponent.setVisible(boolean).

Overrides:

[hide](../../java/awt/Window.html#hide%28%29) in class [Window](../../java/awt/Window.html "class in java.awt")

isResizable

public boolean isResizable()

Indicates whether this dialog is resizable by the user.

Returns:

true if the user can resize the dialog;false otherwise.

See Also:

setResizable(boolean)

setResizable

public void setResizable(boolean resizable)

Sets whether this dialog is resizable by the user.

Parameters:

resizable - true if the user can resize this dialog; false otherwise.

See Also:

isResizable()

setUndecorated

public void setUndecorated(boolean undecorated)

Disables or enables decorations for this dialog. This method can only be called while the dialog is not displayable.

Parameters:

undecorated - true if no dialog decorations are to be enabled;false if dialog decorations are to be enabled.

Throws:

`IllegalComponentStateException` - if the dialog is displayable.

Since:

1.4

isUndecorated

public boolean isUndecorated()

Indicates whether this dialog is undecorated. By default, all dialogs are initially decorated.

Returns:

true if dialog is undecorated; false otherwise.

Since:

1.4

See Also:

setUndecorated(boolean)

paramString

protected String paramString()

Returns a string representing the state of this dialog. This method is intended to be used only for debugging purposes, and the content and format of the returned string may vary between implementations. The returned string may be empty but may not be null.

Overrides:

[paramString](../../java/awt/Container.html#paramString%28%29) in class [Container](../../java/awt/Container.html "class in java.awt")

Returns:

the parameter string of this dialog window.

getAccessibleContext

public AccessibleContext getAccessibleContext()

Gets the AccessibleContext associated with this Dialog. For dialogs, the AccessibleContext takes the form of an AccessibleAWTDialog. A new AccessibleAWTDialog instance is created if necessary.

Specified by:

[getAccessibleContext](../../javax/accessibility/Accessible.html#getAccessibleContext%28%29) in interface [Accessible](../../javax/accessibility/Accessible.html "interface in javax.accessibility")

Overrides:

[getAccessibleContext](../../java/awt/Window.html#getAccessibleContext%28%29) in class [Window](../../java/awt/Window.html "class in java.awt")

Returns:

an AccessibleAWTDialog that serves as the AccessibleContext of this Dialog

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.