Java AWT

Previous Chapter 19
java.awt Reference
Next
 

Dialog

Name

Dialog

[Graphic: Figure from the text]

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); (New)
  public Dialog (Frame parent, boolean modal);
  public Dialog (Frame parent, String title); (New)
  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); (New)
  public synchronized void setResizable (boolean resizable);
  public synchronized void setTitle (String title);
  public void show();  (New)
  
  // Protected Instance Methods
  protected String paramString();
}

Constructors

Dialog

public Dialog (Frame parent) (New)

Parameters

parent

Frame that is to act as the parent of Dialog.

Throws

IllegalArgumentException

If parent is null.

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.

Throws

IllegalArgumentException

If parent is null.

Description

Replaced with Dialog(Frame, String, boolean).

public Dialog (Frame parent, String title) (New)

Parameters

parent

Frame that is to act as parent of Dialog.

title

Initial title to use for Dialog.

Throws

IllegalArgumentException

If parent is null.

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.

Throws

IllegalArgumentException

If parent is null.

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) (New)

Parameters

b

true makes the Dialog modal; false if the Dialog should be modeless.

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.

Description

Changes the resize state of the Dialog.

setTitle

public synchronized void setTitle (String title)

Parameters

title

New title for the Dialog.

Description

Changes the title of the Dialog.

show

public void show() (New)

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


Previous Home Next
Cursor (New) Book Index Dimension

Java in a Nutshell Java Language Reference Java AWT Java Fundamental Classes Exploring Java