borland Packages  Class Hierarchy  jbcl.control Package  Index 

MessageDialog class

java.lang.Object
   +----java.awt.Component
           +----java.awt.Container
                   +----java.awt.Window
                           +----java.awt.Dialog
                                   +----borland.jbcl.control.ButtonDialog
                                           +----borland.jbcl.control.MessageDialog

About the MessageDialog class

Variables  Constructors  Properties  Methods  Event Listeners

Implements ActionListener, KeyListener, ImageObserver, MenuContainer, Serializable, EventListener

MessageDialog is a message box component that displays a text message of your choice and includes a set of buttons the user uses to respond to the message.

To set the message in the message box, set the message property to the string you want to display. The title property contains the text that appears on the title bar of the message box's frame.

The buttonSet property determines which buttons appear in the dialog box. The following button sets are available:

OK "OK" button.
YES "Yes" button.
NO "No" button
CANCEL "Cancel" button
OK_CANCEL "OK" and "Cancel" buttons
YES_NO "Yes" and "No" buttons
YES_NO_CANCEL "Yes", "No", and "Cancel" buttons

When the user selects one of the buttons, its value is stored in the result property. For example, if the user chooses OK, the value of result property becomes OK.

If you prefer to have other labels on the buttons other than the standard OK, Yes, No, and Cancel strings, you can specify your own labels with the labels property. The first string in the labels array becomes the label of the first button in the message box, the second string becomes the label of the second button, and so on.

To display the message box, call the show() method.

Usually you should use Message instead of MessageDialog. Message calls the constructor of MessageDialog, but you can work with Message within the UI Designer and even display it at design time. You can set the properties of MessageDialog only at runtime.


MessageDialog variables

Variables implemented in this class

Variables implemented in borland.jbcl.control.ButtonDialog

Variables implemented in java.awt.Component

MessageDialog constructors

MessageDialog properties

*Read-only properties **Write-only properties

Properties implemented in this class

Properties implemented in borland.jbcl.control.ButtonDialog

Properties implemented in java.awt.Component

Properties implemented in java.awt.Container

Properties implemented in java.awt.Dialog

Properties implemented in java.awt.Window

Properties implemented in java.lang.Object

MessageDialog methods

Methods implemented in borland.jbcl.control.ButtonDialog

Methods implemented in java.awt.Component

Methods implemented in java.awt.Container

Methods implemented in java.awt.Dialog

Methods implemented in java.awt.Window

Methods implemented in java.lang.Object

MessageDialog event listeners


MessageDialog variables

message

  protected Label message

The text to display as the message in the message dialog.

messagePanel

  protected Panel messagePanel

The panel to show in the message dialog.


MessageDialog constructors

MessageDialog(java.awt.Frame)

  public MessageDialog(java.awt.Frame frame)
Constructs a message box with the specified parent frame, no title-bar text, and no message string.

Parameters:

frame
The parent frame for the message box.

MessageDialog(java.awt.Frame, java.lang.String)

  public MessageDialog(java.awt.Frame frame, java.lang.String title)
Constructs a message box with the specified parent frame and title-bar text, and no message string.

Parameters:

frame
The parent frame for the message box.
title
The title-bar text of the message box.

MessageDialog(java.awt.Frame, java.lang.String, java.lang.String)

  public MessageDialog(java.awt.Frame frame, java.lang.String title, java.lang.String msg)
Constructs a message box.

Parameters:

frame
The parent frame for the message box.
title
The title-bar text of the message box.
msg
The message string to display in the message box.

MessageDialog(java.awt.Frame, java.lang.String, java.lang.String, int)

  public MessageDialog(java.awt.Frame frame, java.lang.String title, java.lang.String msg, int buttonSet)
Constructs a message box.

Parameters:

frame
The parent frame for the message box.
title
The title-bar text of the message box.
msg
The message string to display in the message box.
buttonSet
0 - Has an OK button only.
1 - Has OK and Cancel buttons.
2 - Has Yes and No buttons.
3 - Has Yes, No, and Cancel buttons.


MessageDialog properties

message

 public String getMessage()
 public void setMessage(java.lang.String s)
The message string to display in the message box.


MessageDialog event listeners

This class is a source for the following event sets. For information on the standard AWT event sets, see Standard Java events.

action

 public synchronized void addActionListener(java.awt.event.ActionListener l)
 public synchronized void removeActionListener(java.awt.event.ActionListener l)

component

 public synchronized void addComponentListener(java.awt.event.ComponentListener )
 public synchronized void removeComponentListener(java.awt.event.ComponentListener )

container

 public synchronized void addContainerListener(java.awt.event.ContainerListener )
 public void removeContainerListener(java.awt.event.ContainerListener )

focus

 public synchronized void addFocusListener(java.awt.event.FocusListener )
 public synchronized void removeFocusListener(java.awt.event.FocusListener )

key

 public synchronized void addKeyListener(java.awt.event.KeyListener )
 public synchronized void removeKeyListener(java.awt.event.KeyListener )

mouse

 public synchronized void addMouseListener(java.awt.event.MouseListener )
 public synchronized void removeMouseListener(java.awt.event.MouseListener )

mouseMotion

 public synchronized void addMouseMotionListener(java.awt.event.MouseMotionListener )
 public synchronized void removeMouseMotionListener(java.awt.event.MouseMotionListener )

window

 public synchronized void addWindowListener(java.awt.event.WindowListener )
 public synchronized void removeWindowListener(java.awt.event.WindowListener )