multex
Class Awt

java.lang.Object
  |
  +--multex.Awt

public class Awt

extends java.lang.Object

Services for reporting onto AWT windows the messages for any exception. The exception can be

• with parameters (subclass of Exc)
• with cause chain and parameters (subclass of Failure)
• or any standard Java exception (other subclass of java.lang.Throwable)

Method Summary

static void	report(java.awt.Component io_ownerHook, java.lang.Throwable i_throwable) Reports i_throwable blocking the owner Window.
static void	report(java.awt.Component io_ownerHook, java.lang.Throwable i_throwable, boolean i_modal) Reports i_throwable optionally blocking the owner Window, detail description here.
static void	report(java.lang.Throwable i_throwable) Reports i_throwable using a shared owner Frame.
static void	reportNonmodal(java.awt.Component io_ownerHook, java.lang.Throwable i_throwable) Reports i_throwable not blocking the owner Window.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

report

public static void report(java.lang.Throwable i_throwable)

Reports i_throwable using a shared owner Frame. As the shared owner Frame is not visible, there is no use in offering a modal and a non-modal version of this method. Better than using this version of report(), you should call report(java.awt.Component,Throwable) and give it the owner Window or a component, from which the owner Window can be determined.

Reports the same contents as report(java.awt.Component,Throwable,boolean).

report

public static void report(java.awt.Component io_ownerHook,
                          java.lang.Throwable i_throwable)

Reports i_throwable blocking the owner Window. Reports the same contents as report(java.awt.Component,Throwable,boolean).

report

public static void report(java.awt.Component io_ownerHook,
                          java.lang.Throwable i_throwable,
                          boolean i_modal)

Reports i_throwable optionally blocking the owner Window, detail description here. Firstly reports the same as Msg.printMessages(StringBuffer, Throwable) into a pop-up window of appropriate size. Accepting the message is done by

• clicking on the "close window" icon, or
• clicking on the OK-button, or
• typing <RETURN> on the OK-button

Each of these will close the dialog box.

The Button "Show Stack Trace" will add the compactified stack trace including the chain of all causing exceptions to the message dialog box. The contents of the compact stack trace are described at method Msg.printStackTrace(StringBuffer,Throwable).

The owner Window of the dialog box will be determined from io_ownerHook by searching the nearest parent Window. If i_modal holds, will block further input to the owner Window, until this dialog box will be closed.

In an application this method should not be called directly from a GUI class, but the author of each GUI class should set up a method

   private void _report(Throwable e){Awt.report(this,e);}
   

, which will be called from each catch-clause in the event listeners and adds the actual GUI class as the owner of the message dialog.

See Also:

Msg.printReport(StringBuffer,Throwable)

reportNonmodal

public static void reportNonmodal(java.awt.Component io_ownerHook,
                                  java.lang.Throwable i_throwable)

Reports i_throwable not blocking the owner Window. Reports the same contents as report(java.awt.Component,Throwable,boolean).