 |
Chapter 19 java.awt Reference |
 |
Dialog
Name
Dialog
![[Graphic: Figure from the text]](./figs/dialog.gif)
Description
The Dialog class provides a special type of display window that is used for pop-up messages and acquiring input from the user. Unlike most other components, dialogs are hidden by default; you must call show() to display them. Dialogs are always associated with a parent Frame. A Dialog may be either modal or non-modal; a modal dialog attracts all input typed by the user. The default layout for a Dialog is BorderLayout.
Class Definition
public class java.awt.Dialog
extends java.awt.Window {
// Constructors
public Dialog (Frame parent); 
public Dialog (Frame parent, boolean modal);
public Dialog (Frame parent, String title);
public Dialog (Frame parent, String title, boolean modal);
// Instance Methods
public void addNotify();
public String getTitle();
public boolean isModal();
public boolean isResizable();
public void setModal (boolean b);
public synchronized void setResizable (boolean resizable);
public synchronized void setTitle (String title);
public void show();
// Protected Instance Methods
protected String paramString();
}
Constructors
Dialog
public Dialog (Frame parent)
- Parameters
-
- parent
-
Frame that is to act as the parent of Dialog.
- parent
- Throws
-
- IllegalArgumentException
-
If parent is null.
- IllegalArgumentException
- Description
-
Constructs a Dialog object.
public Dialog (Frame parent, boolean modal)
- Parameters
-
- parent
-
Frame that is to act as the parent of Dialog.
- modal
-
true if the Dialog is modal; false otherwise.
- parent
- Throws
-
- IllegalArgumentException
-
If parent is null.
- IllegalArgumentException
- Description
-
Replaced with Dialog(Frame, String, boolean).
public Dialog (Frame parent, String title)
- Parameters
-
- parent
-
Frame that is to act as parent of Dialog.
- title
-
Initial title to use for Dialog.
- parent
- Throws
-
- IllegalArgumentException
-
If parent is null.
- IllegalArgumentException
- Description
-
Constructs a Dialog object with given characteristics.
public Dialog (Frame parent, String title, boolean modal)
- Parameters
-
- parent
-
Frame that is to act as parent of Dialog.
- title
-
Initial title to use for Dialog.
- modal
-
true if the Dialog is modal; false otherwise.
- parent
- Throws
-
- IllegalArgumentException
-
If parent is null.
- IllegalArgumentException
- Description
-
Constructs a Dialog object with given characteristics.
Instance Methods
addNotify
public void addNotify()
- Overrides
-
Window.addNotify()
- Description
-
Creates Dialog's peer and peers of contained components.
getTitle
public String getTitle()
- Returns
-
The current title for the Dialog.
isModal
public boolean isModal()
- Returns
-
true if modal, false otherwise.
isResizable
public boolean isResizable()
- Returns
-
true if resizable, false otherwise.
setModal
public void setModal (boolean b)
- Parameters
-
- b
-
true makes the Dialog modal; false if the Dialog should be modeless.
- b
- Description
-
Changes the modal state of the Dialog.
setResizable
public synchronized void setResizable (boolean resizable)
- Parameters
-
- resizable
-
true makes the Dialog resizable; false if the Dialog cannot be resized.
- resizable
- Description
-
Changes the resize state of the Dialog.
setTitle
public synchronized void setTitle (String title)
- Parameters
-
- title
-
New title for the Dialog.
- title
- Description
-
Changes the title of the Dialog.
show
public void show()
- Overrides
-
Window.show()
- Description
-
If the dialog is hidden, this method shows it. If the dialog is already visible, this method brings it to the front.
Protected Instance Methods
paramString
protected String paramString()
- Returns
-
String with current settings of Dialog.
- Overrides
-
Container.paramString()
- Description
-
Helper method for toString() to generate string of current settings.
See Also
FileDialog, Frame, String, Window, WindowEvent, WindowListener
|
 |
|
| Cursor |
 |
Dimension |
