borland Packages  Class Hierarchy  jbcl.control Package  Index 

ExceptionDialog class

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

About the ExceptionDialog class

Variables  Constructors  Properties  Methods  Event Listeners

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

The ExceptionDialog class displays an error dialog when a DataSetException is generated. The DataSetException class can have other types of exceptions chained to it, for example, java.io.IOException and java.sql.SQLException exceptions. In these cases the DataSetException has an appropriate message that describes the error from the perspective of the higher level API. Select the Previous, Next, or Details buttons to view the stack of exceptions in the chain.

If the exception thrown is of type ValidationException (a subclass of DataSetException), the Exception dialog displays only if there are no StatusEvent listeners on the DataSet, for example, the StatusBar control. A ValidationException is generated by a constraint violation, for example, a minimum or maximum value outside specified ranges, a data entry that doesn't meet an edit mask specification, an attempt at updating a read-only column, and so on. If a StatusBar control is bound to a DataSet, it automatically becomes a StatusEvent listener. This allows users to see the messages resulting from constraint violations on the status bar.

This dialog is suppressed when a DataSetException is generated in the JBuilder UI Designer.

To programmatically suppress this dialog at run time, set the displayErrors property of the DataSet to false.


ExceptionDialog variables

Variables implemented in borland.jbcl.control.ButtonDialog

Variables implemented in java.awt.Component

ExceptionDialog constructors

ExceptionDialog properties

*Read-only properties **Write-only properties

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

ExceptionDialog methods

Methods implemented in this class

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

ExceptionDialog event listeners


ExceptionDialog constructors

ExceptionDialog(java.awt.Frame, java.lang.String, java.lang.Exception)

  public ExceptionDialog(java.awt.Frame frame, java.lang.String title, java.lang.Exception ex)
Constructs an ExceptionDialog by calling its superclass constructor with the properties specified by its parameters. This constructor creates a modal dialog. To create a non-modal ExceptionDialog, use the ExceptionDialog(java.awt.Frame, java.lang.String, java.lang.Exception, boolean) constructor.

Parameters:

frame
The Frame class that is passed to its superclass constructor.
title
The title used in the dialog window.
ex
The Exception class.

ExceptionDialog(java.awt.Frame, java.lang.String, java.lang.Exception, boolean)

  public ExceptionDialog(java.awt.Frame frame, java.lang.String title, java.lang.Exception ex, boolean modal)
Constructs an ExceptionDialog by calling its superclass constructor with the properties specified by its parameters.

Parameters:

frame
The Frame class that is passed to its superclass constructor.
title
The title used in the dialog window.
ex
The Exception class.
modal
Whether the ExceptionDialog is modal or not. A modal dialog must be dismissed before using the rest of the program.

ExceptionDialog(java.awt.Frame, java.lang.String, java.lang.Exception, boolean, java.awt.Component)

  public ExceptionDialog(java.awt.Frame frame, java.lang.String title, java.lang.Exception ex, boolean modal, java.awt.Component c)

ExceptionDialog(java.awt.Frame, java.lang.String, java.lang.Exception, java.awt.Component)

  public ExceptionDialog(java.awt.Frame frame, java.lang.String title, java.lang.Exception ex, java.awt.Component c)

ExceptionDialog methods

getShowCount()

  public static int getShowCount()
Returns the number of errors in the chain.

processActionEvent(java.awt.event.ActionEvent)

  protected void processActionEvent(java.awt.event.ActionEvent e)
Protected method that calls its superclass constructor processActionEvent() method with the chained Exception event, then determines the appropriate action based on user input. For example, if the Next button is clicked, show the next Exception in the chained list.

Parameters:

e
The chained Exception event.

Overrides: borland.jbcl.control.ButtonDialog.processActionEvent(ActionEvent)

processWindowEvent(java.awt.event.WindowEvent)

  protected void processWindowEvent(java.awt.event.WindowEvent e)
Protected method that overrides the windows event handler.

Parameters:

e
The chained Exception event.

Overrides: borland.jbcl.control.ButtonDialog.processWindowEvent(WindowEvent)


ExceptionDialog 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 )