|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Objectjava.awt.Component
java.awt.Container
java.awt.Window
java.awt.Dialog
public class Dialog
Dialog provides a top-level window normally used to receive
user input in applications.
A dialog always has another top-level window as owner and is only visible
if this owner is visible to the user. The default layout of dialogs is the
BorderLayout. Dialogs can be modal (blocks user input to other
components) or non-modal (user input in other components are allowed).
| Nested Class Summary | |
|---|---|
protected class |
Dialog.AccessibleAWTDialog
Accessibility support for Dialog. |
static class |
Dialog.ModalExclusionType
|
static class |
Dialog.ModalityType
|
| 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)
Initializes a new instance of Dialog with the specified,
parent, that is resizable. |
|
Dialog(Dialog owner,
String title)
Initializes a new instance of Dialog with the specified,
parent and title, that is resizable. |
|
Dialog(Dialog owner,
String title,
boolean modal)
Initializes a new instance of Dialog with the specified,
parent, title and modality, that is resizable. |
|
Dialog(Dialog parent,
String title,
boolean modal,
GraphicsConfiguration gc)
Initializes a new instance of Dialog with the specified,
parent, title, modality and GraphicsConfiguration, that is
resizable. |
|
Dialog(Frame parent)
Initializes a new instance of Dialog with the specified
parent, that is resizable and not modal, and which has no title. |
|
Dialog(Frame parent,
boolean modal)
Initializes a new instance of Dialog with the specified
parent and modality, that is resizable and which has no title. |
|
Dialog(Frame parent,
String title)
Initializes a new instance of Dialog with the specified
parent, that is resizable and not modal, and which has the specified
title. |
|
Dialog(Frame parent,
String title,
boolean modal)
Initializes a new instance of Dialog with the specified,
parent, title, and modality, that is resizable. |
|
Dialog(Frame parent,
String title,
boolean modal,
GraphicsConfiguration gc)
Initializes a new instance of Dialog with the specified,
parent, title, modality and GraphicsConfiguration, that is
resizable. |
|
| Method Summary | |
|---|---|
void |
addNotify()
Creates this object's native peer. |
void |
dispose()
Disposes the Dialog and then causes show() to return if it is currently blocked. |
AccessibleContext |
getAccessibleContext()
Gets the AccessibleContext associated with this Dialog. |
String |
getTitle()
Returns the title of this dialog box. |
void |
hide()
Deprecated. Use Component.setVisible(boolean) instead. |
boolean |
isModal()
Tests whether or not this dialog box is modal. |
boolean |
isResizable()
Tests whether or not this dialog box is resizable. |
boolean |
isUndecorated()
Returns whether this frame is undecorated or not. |
protected String |
paramString()
Returns a debugging string for this component. |
void |
setModal(boolean modal)
Changes the modality of this dialog box. |
void |
setResizable(boolean resizable)
Changes the resizability of this dialog box. |
void |
setTitle(String title)
Sets the title of this dialog box to the specified string. |
void |
setUndecorated(boolean undecorated)
Disables or enables decorations for this frame. |
void |
show()
Deprecated. Use Component.setVisible(boolean) instead. |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
| Constructor Detail |
|---|
public Dialog(Frame parent)
Dialog with the specified
parent, that is resizable and not modal, and which has no title.
parent - The parent frame of this dialog box.
IllegalArgumentException - If the owner's GraphicsConfiguration
is not from a screen device, or if owner is null. This exception is
always thrown when GraphicsEnvironment.isHeadless() returns true.
public Dialog(Frame parent,
boolean modal)
Dialog with the specified
parent and modality, that is resizable and which has no title.
parent - The parent frame of this dialog box.modal - true if this dialog box is modal,
false otherwise.
IllegalArgumentException - If the owner's GraphicsConfiguration
is not from a screen device, or if owner is null. This exception is
always thrown when GraphicsEnvironment.isHeadless() returns true.
public Dialog(Frame parent,
String title)
Dialog with the specified
parent, that is resizable and not modal, and which has the specified
title.
parent - The parent frame of this dialog box.title - The title string for this dialog box.
IllegalArgumentException - If the owner's GraphicsConfiguration
is not from a screen device, or if owner is null. This exceptionnis
always thrown when GraphicsEnvironment.isHeadless() returns true.
public Dialog(Frame parent,
String title,
boolean modal)
Dialog with the specified,
parent, title, and modality, that is resizable.
parent - The parent frame of this dialog box.title - The title string for this dialog box.modal - true if this dialog box is modal,
false otherwise.
IllegalArgumentException - If owner is null or
GraphicsEnvironment.isHeadless() returns true.
public Dialog(Frame parent,
String title,
boolean modal,
GraphicsConfiguration gc)
Dialog with the specified,
parent, title, modality and GraphicsConfiguration, that is
resizable.
parent - The parent frame of this dialog box.title - The title string for this dialog box.modal - true if this dialog box is modal,
false otherwise.gc - The GraphicsConfiguration object to use. If
null the GraphicsConfiguration of the target
frame is used.
IllegalArgumentException - If owner is null, the
GraphicsConfiguration is not a screen device or
GraphicsEnvironment.isHeadless() returns true.public Dialog(Dialog owner)
Dialog with the specified,
parent, that is resizable.
owner - The parent frame of this dialog box.
IllegalArgumentException - If parent is null. This exception is
always thrown when GraphicsEnvironment.isHeadless() returns true.
public Dialog(Dialog owner,
String title)
Dialog with the specified,
parent and title, that is resizable.
owner - The parent frame of this dialog box.title - The title string for this dialog box.
IllegalArgumentException - If parent is null. This exception is
always thrown when GraphicsEnvironment.isHeadless() returns
true.
public Dialog(Dialog owner,
String title,
boolean modal)
Dialog with the specified,
parent, title and modality, that is resizable.
owner - The parent frame of this dialog box.title - The title string for this dialog box.modal - true if this dialog box is modal,
false otherwise.
IllegalArgumentException - If parent is null. This exception is
always thrown when GraphicsEnvironment.isHeadless() returns true.
public Dialog(Dialog parent,
String title,
boolean modal,
GraphicsConfiguration gc)
Dialog with the specified,
parent, title, modality and GraphicsConfiguration, that is
resizable.
parent - The parent frame of this dialog box.title - The title string for this dialog box.modal - true if this dialog box is modal,
false otherwise.gc - The GraphicsConfiguration object to use. If
null the GraphicsConfiguration of the target
frame is used.
IllegalArgumentException - If parent is null, the
GraphicsConfiguration is not a screen device or
GraphicsEnvironment.isHeadless() returns true.| Method Detail |
|---|
public String getTitle()
public void setTitle(String title)
title - the new title. If null an empty
title will be set.public boolean isModal()
true if this dialog box is modal, false
otherwise.public void setModal(boolean modal)
modal - true to make this dialog box modal,
false to make it non-modal.public boolean isResizable()
true if this dialog is resizable,
false otherwise.public void setResizable(boolean resizable)
resizable - true to make this dialog resizable,
false to make it non-resizable.public void addNotify()
addNotify in class WindowComponent.isDisplayable(),
Component.removeNotify()public void show()
Component.setVisible(boolean) instead.
show in class Windowpublic void hide()
Component.setVisible(boolean) instead.
hide in class Windowpublic void dispose()
dispose in class Windowprotected String paramString()
paramString in class Containerpublic boolean isUndecorated()
true if this dialog is undecorated,
false otherwise.public void setUndecorated(boolean undecorated)
undecorated - true to disable dialog decorations,
false otherwise.
IllegalComponentStateException - If this frame is displayable.public AccessibleContext getAccessibleContext()
Dialog. The
context is created, if necessary.
getAccessibleContext in interface AccessiblegetAccessibleContext in class Window
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||