TopBlend:
Here is the
first difference.
There are 99 differences.
is old.
is new.
java.awt
Class Dialog
java.lang.Object
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 of width - (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
may
must
have
either a frame or
another
window
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
some
all
other
top-level
toplevel
windows in the application, except for any windows created with the dialog as their owner.
See
AWT Modality
specification for details.
Dialogs are capable of generating the following WindowEvents: WindowOpened, WindowClosing, WindowClosed, WindowActivated, WindowDeactivated, WindowGainedFocus, WindowLostFocus.
-
Since:
-
JDK1.0
-
See Also:
-
WindowEvent
,
Window.addWindowListener(java.awt.event.WindowListener)
,
Serialized Form
Nested classes/interfaces inherited from class java.awt.
Window
|
Window.AccessibleAWTWindow
|
Nested classes/interfaces inherited from class java.awt.
Container
|
Container.AccessibleAWTContainer
|
Fields inherited from interface java.awt.image.
ImageObserver
|
ABORT
,
ALLBITS
,
ERROR
,
FRAMEBITS
,
HEIGHT
,
PROPERTIES
,
SOMEBITS
,
WIDTH
|
Constructor Summary
|
Dialog
(
Dialog
Constructs an initially invisible,
modeless
non-modal
Dialog with
an empty title and
the specified owner
Dialog and an empty title.
dialog.
|
Dialog
(
Dialog
owner,
String
Constructs an initially invisible,
modeless
non-modal
Dialog with the specified owner
Dialog
dialog
and title. |
Dialog
(
Dialog
owner,
String
Constructs an initially invisible Dialog with the specified owner
Dialog,
dialog,
title, and modality. |
Dialog
(
Dialog
owner,
String
title, boolean modal,
GraphicsConfiguration
Constructs an initially invisible Dialog with the specified owner
Dialog,
dialog,
title,
modality
modality,
and GraphicsConfiguration. |
Dialog
(
Frame
Constructs an initially invisible,
modeless
non-modal
Dialog with
an empty title and
the specified owner
Frame and an empty title.
frame.
|
Dialog
(
Frame
Constructs an initially invisible Dialog with
an empty title,
the specified owner
Frame
frame
and
modality and an empty title.
modality.
|
Dialog
(
Frame
owner,
String
Constructs an initially invisible,
modeless
non-modal
Dialog with the specified owner
Frame
frame
and title. |
Dialog
(
Frame
owner,
String
Constructs an initially invisible Dialog with the specified owner
Frame, title
frame, title,
and modality. |
Dialog
(
Frame
owner,
String
title, boolean modal,
GraphicsConfiguration
Constructs an initially invisible Dialog with the specified owner
Frame,
frame,
title, modality, and GraphicsConfiguration. |
Dialog
(
Window
Constructs an initially invisible, modeless Dialog with the specified owner Window and an empty title.
|
Dialog
(
Window
owner,
Dialog.ModalityType
Constructs an initially invisible Dialog with the specified owner Window and modality and an empty title.
|
Dialog
(
Window
owner,
String
Constructs an initially invisible, modeless Dialog with the specified owner Window and title.
|
Dialog
(
Window
owner,
String
title,
Dialog.ModalityType
Constructs an initially invisible Dialog with the specified owner Window, title and modality.
|
Dialog
(
Window
owner,
String
title,
Dialog.ModalityType
modalityType,
GraphicsConfiguration
Constructs an initially invisible Dialog with the specified owner Window, title, modality and GraphicsConfiguration.
|
Methods inherited from class java.awt.
Window
|
addPropertyChangeListener
,
addPropertyChangeListener
,
addWindowFocusListener
,
addWindowListener
,
addWindowStateListener
,
applyResourceBundle
,
applyResourceBundle
,
createBufferStrategy
,
createBufferStrategy
,
dispose
,
finalize
,
getBufferStrategy
,
getFocusableWindowState
,
getFocusCycleRootAncestor
,
getFocusOwner
,
getFocusTraversalKeys
,
getGraphicsConfiguration
,
getInputContext
,
getListeners
,
getLocale
,
getModalExclusionType
,
getMostRecentFocusOwner
,
getOwnedWindows
,
getOwner
,
getToolkit
,
getWarningString
,
getWindowFocusListeners
,
getWindowListeners
,
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
,
setLocationByPlatform
,
setLocationRelativeTo
,
setMinimumSize
toBack
,
setModalExclusionType
,
setSize
,
setSize
,
toFront
|
Methods inherited from class 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
|
Methods inherited from class 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
,
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
|
Field Detail
|
DEFAULT_MODALITY_TYPE
public static final Dialog.ModalityTypeDEFAULT_MODALITY_TYPE
-
Default modality type for modal dialogs. The default modality type is APPLICATION_MODAL. Calling the oldstyle setModal(true) is equal to setModalityType(DEFAULT_MODALITY_TYPE).
-
Since:
-
1.6
-
See Also:
-
Dialog.ModalityType
,
setModal(boolean)
Dialog
public Dialog(Frame owner)
-
Constructs an initially invisible,
modeless
non-modal
Dialog with
an empty title and
the specified owner
Frame and an empty title.
frame.
-
Parameters:
-
owner - the owner of the dialog
or null if this dialog has no owner
-
Throws:
-
IllegalArgumentException
- if the owner's GraphicsConfiguration is not from a screen device
-
IllegalArgumentException
- when GraphicsEnvironment.isHeadless() returns true
- if owner is null; this exception is always thrown when GraphicsEnvironment.isHeadless returns true
-
See Also:
-
GraphicsEnvironment.isHeadless()
,
Component.setSize(int, int)
,
Component.setVisible(boolean)
Dialog
public Dialog(Frame owner,
boolean modal)
-
Constructs an initially invisible Dialog with
an empty title,
the specified owner
Frame
frame
and
modality and an empty title.
modality.
-
Parameters:
-
owner - the owner of the dialog
or null if this dialog has no owner
-
modal - specifes whether dialog blocks user input to other top-level windows when shown. If false, the dialog is MODELESS; if true, the modality type property is set to DEFAULT_MODALITY_TYPE
modal - if true, dialog blocks input to other app windows when shown
-
Throws:
-
IllegalArgumentException
- if the owner's GraphicsConfiguration is not from a screen device
-
IllegalArgumentException
- when GraphicsEnvironment.isHeadless() returns true
- if owner is null; this exception is always thrown when GraphicsEnvironment.isHeadless returns true
-
See Also:
-
Dialog.ModalityType
GraphicsEnvironment.isHeadless()
,
Dialog.ModalityType.MODELESS
,
DEFAULT_MODALITY_TYPE
,
setModal(boolean)
,
setModalityType(java.awt.Dialog.ModalityType)
,
GraphicsEnvironment.isHeadless()
Dialog
public Dialog(Frame owner,
String title)
-
Constructs an initially invisible,
modeless
non-modal
Dialog with the specified owner
Frame
frame
and title.
-
Parameters:
-
owner - the owner of the dialog
or null if this dialog has no owner
-
title - the title of the dialog or null if this dialog has no title
title - the title of the dialog; a null value will be accepted without causing a NullPointerException to be thrown
-
Throws:
-
IllegalArgumentException
- if the owner's GraphicsConfiguration is not from a screen device
-
IllegalArgumentException
- when GraphicsEnvironment.isHeadless() returns true
- if owner is null; this exception is always thrown when GraphicsEnvironment.isHeadless returns true
-
See Also:
-
GraphicsEnvironment.isHeadless()
,
Component.setSize(int, int)
,
Component.setVisible(boolean)
Dialog
public Dialog(Frame owner,
String title,
boolean modal)
-
Constructs an initially invisible Dialog with the specified owner
Frame, title
frame, title,
and modality.
-
Parameters:
-
owner - the owner of the dialog
or null if this dialog has no owner
-
title - the title of the dialog or null if this dialog has no title
title - the title of the dialog; a null value will be accepted without causing a NullPointerException to be thrown
-
modal - specifes whether dialog blocks user input to other top-level windows when shown. If false, the dialog is MODELESS; if true, the modality type property is set to DEFAULT_MODALITY_TYPE
modal - if true, dialog blocks input to other app windows when shown
-
Throws:
-
IllegalArgumentException
- if the owner's GraphicsConfiguration is not from a screen device
-
IllegalArgumentException
- when GraphicsEnvironment.isHeadless() returns true
- if owner is null. This exception is always thrown when GraphicsEnvironment.isHeadless returns true
-
See Also:
-
Dialog.ModalityType
GraphicsEnvironment.isHeadless()
,
Dialog.ModalityType.MODELESS
,
DEFAULT_MODALITY_TYPE
,
setModal(boolean)
,
setModalityType(java.awt.Dialog.ModalityType)
,
GraphicsEnvironment.isHeadless()
,
Component.setSize(int, int)
,
Component.setVisible(boolean)
Dialog
public Dialog(Frame owner,
String title,
boolean modal,
GraphicsConfiguration gc)
-
Constructs an initially invisible Dialog with the specified owner
Frame,
frame,
title, modality, and GraphicsConfiguration.
-
Parameters:
-
owner - the owner of the dialog
or null if this dialog has no owner
-
title - the title of the dialog or null if this dialog has no title
title - the title of the dialog. A null value will be accepted without causing a NullPointerException to be thrown.
-
modal - specifes whether dialog blocks user input to other top-level windows when shown. If false, the dialog is MODELESS; if true, the modality type property is set to DEFAULT_MODALITY_TYPE
modal - if true, dialog blocks input to other app windows when shown
-
gc - the GraphicsConfiguration of the target screen
device; if
device. If gc is
null, the
default system
same
GraphicsConfiguration
as the owning Frame
is
assumed
used.
-
Throws:
-
IllegalArgumentException
-
if owner is null. This exception is always thrown
when GraphicsEnvironment.isHeadless() returns true -
Since:
-
1.4
-
See Also:
-
Dialog.ModalityType
GraphicsEnvironment.isHeadless()
,
Dialog.ModalityType.MODELESS
,
DEFAULT_MODALITY_TYPE
,
setModal(boolean)
,
setModalityType(java.awt.Dialog.ModalityType)
,
GraphicsEnvironment.isHeadless()
,
Component.setSize(int, int)
,
Component.setVisible(boolean)
Dialog
public Dialog(Dialog owner)
-
Constructs an initially invisible,
modeless
non-modal
Dialog with
an empty title and
the specified owner
Dialog and an empty title.
dialog.
-
Parameters:
-
owner - the owner of the dialog
or null if this dialog has no owner
-
Throws:
-
IllegalArgumentException
-
if owner is null. This exception is always thrown
when GraphicsEnvironment.isHeadless() returns true -
Since:
-
1.2
-
See Also:
-
GraphicsEnvironment.isHeadless()
Dialog
public Dialog(Dialog owner,
String title)
-
Constructs an initially invisible,
modeless
non-modal
Dialog with the specified owner
Dialog
dialog
and title.
-
Parameters:
-
owner - the owner of the dialog
or null if this has no owner
-
title - the title of the dialog or null if this dialog has no title
title - the title of the dialog. A null value will be accepted without causing a NullPointerException to be thrown.
-
Throws:
-
IllegalArgumentException
-
if owner is null. This exception is always thrown
when GraphicsEnvironment.isHeadless() returns true -
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,
dialog,
title, and modality.
-
Parameters:
-
owner - the owner of the dialog
or null if this dialog has no owner
-
title - the title of the dialog or null if this dialog has no title
title - the title of the dialog; a null value will be accepted without causing a NullPointerException to be thrown
-
modal - specifes whether dialog blocks user input to other top-level windows when shown. If false, the dialog is MODELESS; if true, the modality type property is set to DEFAULT_MODALITY_TYPE
modal - if true, dialog blocks input to other app windows when shown
-
Throws:
-
IllegalArgumentException
- if the owner's GraphicsConfiguration is not from a screen device
-
IllegalArgumentException
- when GraphicsEnvironment.isHeadless() returns true
- if owner is null; this exception is always thrown when GraphicsEnvironment.isHeadless returns true
-
Since:
-
1.2
-
See Also:
-
Dialog.ModalityType
GraphicsEnvironment.isHeadless()
,
Dialog.ModalityType.MODELESS
,
DEFAULT_MODALITY_TYPE
,
setModal(boolean)
,
setModalityType(java.awt.Dialog.ModalityType)
,
GraphicsEnvironment.isHeadless()
Dialog
public Dialog(Dialog owner,
String title,
boolean modal,
GraphicsConfiguration gc)
-
Constructs an initially invisible Dialog with the specified owner
Dialog,
dialog,
title,
modality
modality,
and GraphicsConfiguration.
-
Parameters:
-
owner - the owner of the dialog
or null if this dialog has no owner
-
title - the title of the dialog or null if this dialog has no title
title - the title of the dialog; a null value will be accepted without causing a NullPointerException to be thrown
-
modal - specifes whether dialog blocks user input to other top-level windows when shown. If false, the dialog is MODELESS; if true, the modality type property is set to DEFAULT_MODALITY_TYPE
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
default system
same
GraphicsConfiguration
as the owning Dialog
is
assumed
used
-
Throws:
-
IllegalArgumentException
- if the owner's GraphicsConfiguration is not from a screen device
-
IllegalArgumentException
- when GraphicsEnvironment.isHeadless() returns true
- if owner is null; this exception is always thrown when GraphicsEnvironment.isHeadless returns true
-
Since:
-
1.4
-
See Also:
-
Dialog.ModalityType
GraphicsEnvironment.isHeadless()
,
Dialog.ModalityType.MODELESS
,
DEFAULT_MODALITY_TYPE
,
setModal(boolean)
,
setModalityType(java.awt.Dialog.ModalityType)
,
GraphicsEnvironment.isHeadless()
,
Component.setSize(int, int)
,
Component.setVisible(boolean)
Dialog
public Dialog ( Window owner)
-
Constructs an initially invisible, modeless Dialog with the specified owner Window and an empty title.
-
Parameters:
-
owner - the owner of the dialog. The owner must be an instance of
Dialog
,
Frame
, any of their descendents or null
-
Throws:
-
IllegalArgumentException
- if the owner is not an instance of
Dialog
or
Frame
-
IllegalArgumentException
- if the owner's GraphicsConfiguration is not from a screen device
-
IllegalArgumentException
- when GraphicsEnvironment.isHeadless() returns true
-
Since:
-
1.6
-
See Also:
-
GraphicsEnvironment.isHeadless()
Dialog
public Dialog ( Window owner,
String title)
-
Constructs an initially invisible, modeless Dialog with the specified owner Window and title.
-
Parameters:
-
owner - the owner of the dialog. The owner must be an instance of
Dialog
,
Frame
, any of their descendents or null
-
title - the title of the dialog or null if this dialog has no title
-
Throws:
-
IllegalArgumentException
- if the owner is not an instance of
Dialog
or
Frame
-
IllegalArgumentException
- if the owner's GraphicsConfiguration is not from a screen device
-
IllegalArgumentException
- when GraphicsEnvironment.isHeadless() returns true
-
Since:
-
1.6
-
See Also:
-
GraphicsEnvironment.isHeadless()
Dialog
public Dialog ( Window owner,
Dialog.ModalityType modalityType)
-
Constructs an initially invisible Dialog with the specified owner Window and modality and an empty title.
-
Parameters:
-
owner - the owner of the dialog. The owner must be an instance of
Dialog
,
Frame
, any of their descendents or null
-
modalityType - specifies whether dialog blocks input to other windows when shown. null value and unsupported modality types are equivalent to MODELESS
-
Throws:
-
IllegalArgumentException
- if the owner is not an instance of
Dialog
or
Frame
-
IllegalArgumentException
- if the owner's GraphicsConfiguration is not from a screen device
-
IllegalArgumentException
- when GraphicsEnvironment.isHeadless() returns true
-
SecurityException
- if the calling thread does not have permission to create modal dialogs with the given modalityType
-
Since:
-
1.6
-
See Also:
-
Dialog.ModalityType
,
setModal(boolean)
,
setModalityType(java.awt.Dialog.ModalityType)
,
GraphicsEnvironment.isHeadless()
,
Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)
Dialog
public Dialog ( Window owner,
String title,
Dialog.ModalityType modalityType)
-
Constructs an initially invisible Dialog with the specified owner Window, title and modality.
-
Parameters:
-
owner - the owner of the dialog. The owner must be an instance of
Dialog
,
Frame
, any of their descendents or null
-
title - the title of the dialog or null if this dialog has no title
-
modalityType - specifies whether dialog blocks input to other windows when shown. null value and unsupported modality types are equivalent to MODELESS
-
Throws:
-
IllegalArgumentException
- if the owner is not an instance of
Dialog
or
Frame
-
IllegalArgumentException
- if the owner's GraphicsConfiguration is not from a screen device
-
IllegalArgumentException
- when GraphicsEnvironment.isHeadless() returns true
-
SecurityException
- if the calling thread does not have permission to create modal dialogs with the given modalityType
-
Since:
-
1.6
-
See Also:
-
Dialog.ModalityType
,
setModal(boolean)
,
setModalityType(java.awt.Dialog.ModalityType)
,
GraphicsEnvironment.isHeadless()
,
Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)
Dialog
public Dialog ( Window owner,
String title,
Dialog.ModalityType modalityType,
GraphicsConfiguration gc)
-
Constructs an initially invisible Dialog with the specified owner Window, title, modality and GraphicsConfiguration.
-
Parameters:
-
owner - the owner of the dialog. The owner must be an instance of
Dialog
,
Frame
, any of their descendents or null
-
title - the title of the dialog or null if this dialog has no title
-
modalityType - specifies whether dialog blocks input to other windows when shown. null value and unsupported modality types are equivalent to MODELESS
-
gc - the GraphicsConfiguration of the target screen device; if null, the default system GraphicsConfiguration is assumed
-
Throws:
-
IllegalArgumentException
- if the owner is not an instance of
Dialog
or
Frame
-
IllegalArgumentException
- if the owner's GraphicsConfiguration is not from a screen device
-
IllegalArgumentException
- when GraphicsEnvironment.isHeadless() returns true
-
SecurityException
- if the calling thread does not have permission to create modal dialogs with the given modalityType
-
Since:
-
1.6
-
See Also:
-
Dialog.ModalityType
,
setModal(boolean)
,
setModalityType(java.awt.Dialog.ModalityType)
,
GraphicsEnvironment.isHeadless()
,
Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)
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
in class
Window
-
-
See Also:
-
Component.isDisplayable()
,
Window.removeNotify()
Container.removeNotify()
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.
This method is obsolete and is kept for backwards compatiblity only. Use
getModalityType()
instead.
-
-
Returns:
-
true if this dialog window is modal; false
otherwise
otherwise.
-
See Also:
-
DEFAULT_MODALITY_TYPE
setModal(boolean)
,
Dialog.ModalityType.MODELESS
,
setModal(boolean)
,
getModalityType()
,
setModalityType(java.awt.Dialog.ModalityType)
setModal
public void setModal(boolean modal) (boolean b)
-
Specifies whether this dialog should be modal.
This method is obsolete and is kept for backwards compatibility only. Use
setModalityType()
instead.
Note: changing modality of the visible dialog may have no effect until it is hidden and then shown again.
-
-
Parameters:
-
modal - specifies whether dialog blocks input to other windows when shown; calling to setModal(true) is equivalent to setModalityType(Dialog.DEFAULT_MODALITY_TYPE), and calling to setModal(false) is equvivalent to setModalityType(Dialog.ModalityType.MODELESS)
-
Since:
-
1.1
JDK1.1
-
See Also:
-
DEFAULT_MODALITY_TYPE
isModal()
,
Dialog.ModalityType.MODELESS
,
isModal()
,
getModalityType()
,
setModalityType(java.awt.Dialog.ModalityType)
getModalityType
public Dialog.ModalityTypegetModalityType ()
-
Returns the modality type of this dialog.
-
-
Returns:
-
modality type of this dialog
-
Since:
-
1.6
-
See Also:
-
setModalityType(java.awt.Dialog.ModalityType)
setModalityType
public void setModalityType ( Dialog.ModalityType type)
-
Sets the modality type for this dialog. See
ModalityType
for possible modality types.
If the given modality type is not supported, MODELESS is used. You may want to call getModalityType() after calling this method to ensure that the modality type has been set.
Note: changing modality of the visible dialog may have no effect until it is hidden and then shown again.
-
-
Parameters:
-
type - specifies whether dialog blocks input to other windows when shown. null value and unsupported modality types are equivalent to MODELESS
-
Throws:
-
SecurityException
- if the calling thread does not have permission to create modal dialogs with the given modalityType
-
Since:
-
1.6
-
See Also:
-
getModalityType()
,
Toolkit.isModalityTypeSupported(java.awt.Dialog.ModalityType)
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 be null.
-
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()
setVisible
public void setVisible (boolean b)
-
Shows or hides this Dialog depending on the value of parameter b.
-
-
Overrides:
-
setVisible
in class
Window
-
-
Parameters:
-
b - if true, makes the Dialog visible, otherwise hides the Dialog. If the dialog and/or its owner are not yet displayable, both are made displayable. The dialog will be validated prior to being made visible. If false, hides the Dialog and then causes setVisible(true) to return if it is currently blocked.
Notes for modal dialogs
.
-
setVisible(true): If the dialog is not already visible, this call will not return until the dialog is hidden by calling setVisible(false) or dispose.
-
setVisible(false): Hides the dialog and then returns on setVisible(true) if it is currently blocked.
-
It is OK to call this method from the event dispatching thread because the toolkit ensures that other events are not blocked while this method is blocked.
-
See Also:
-
Window.setVisible(boolean)
,
Window.dispose()
,
Component.isDisplayable()
,
Component.validate()
,
isModal()
show
@Deprecated
public void show()
-
Deprecated.
As of JDK version 1.5, replaced by
setVisible(boolean)
Component.setVisible(boolean)
.
-
Makes the Dialog visible. If the dialog and/or its owner are not yet displayable, both are made displayable. The dialog will be validated prior to being made visible. If the dialog is already visible, this will bring the dialog to the front.
If the dialog is modal and is not already visible, this call will not return until the dialog is hidden by calling hide or dispose. It is permissible to show modal dialogs from the event dispatching thread because the toolkit will ensure that another event pump runs while the one which invoked this method is blocked.
-
-
Overrides:
-
show
in class
Window
-
-
See Also:
-
Component.hide()
,
Component.isDisplayable()
,
Component.validate()
,
isModal()
,
Window.setVisible(boolean)
hide
@Deprecated
public void hide()
-
Deprecated.
As of JDK version 1.5, replaced by
setVisible(boolean)
Component.setVisible(boolean)
.
-
Hides the Dialog and then causes show to return if it is currently blocked.
-
-
Overrides:
-
hide
in class
Window
-
-
See Also:
-
Window.show()
,
Window.dispose()
,
Window.setVisible(boolean)
toBack
public void toBack ()
-
If this Window is visible, sends this Window to the back and may cause it to lose focus or activation if it is the focused or active Window.
Places this Window at the bottom of the stacking order and shows it behind any other Windows in this VM. No action will take place is this Window is not visible. Some platforms do not allow Windows which are owned by other Windows to appear below their owners. Every attempt will be made to move this Window as low as possible in the stacking order; however, developers should not assume that this method will move this Window below all other windows in every situation.
Because of variations in native windowing systems, no guarantees about changes to the focused and active Windows can be made. Developers must never assume that this Window is no longer the focused or active Window until this Window receives a WINDOW_LOST_FOCUS or WINDOW_DEACTIVATED event. On platforms where the top-most window is the focused window, this method will
probably
cause this Window to lose focus. In that case, the next highest, focusable Window in this VM will receive focus. On platforms where the stacking order does not typically affect the focused window, this method will
probably
leave the focused and active Windows unchanged.
If this dialog is modal and blocks some windows, then all of them are also sent to the back to keep them below the blocking dialog.
-
-
Overrides:
-
toBack
in class
Window
-
-
See Also:
-
Window.toBack()
isResizable
public boolean isResizable()
-
Indicates whether this dialog is resizable by the user.
By default, all dialogs are initially resizable.
-
-
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
-
See Also:
-
isUndecorated()
,
Component.isDisplayable()
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
in class
Container
-
-
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
in interface
Accessible
-
Overrides:
-
getAccessibleContext
in class
Window
-
-
Returns:
-
an AccessibleAWTDialog that serves as the AccessibleContext of this Dialog