Class: Warning

• Inheritance
• Description
• Related information
• Class protocol
  • initialization
  • misc ui support
• Instance protocol
  • accessing
  • default actions
• Examples

Inheritance:

   Object
   |
   +--GenericException
      |
      +--Notification
         |
         +--UserNotification
            |
            +--Warning
               |
               +--ClassBuildWarning
               |
               +--HTML::HTMLParseWarning
               |
               +--ProceedError

Package:

stx:libbasic

Category:

Kernel-Exceptions

Version:

rev: 1.20 date: 2019/04/30 11:00:22

user: cg

file: Warning.st directory: libbasic

module: stx stc-classLibrary: libbasic

Author:

Stefan Vogel

Description:

Warning is the superclass of all warning signals in the system.
The default beavior for an unhandled Warning is to display a warn
box with the error decription. If no display is available, the error 
description is written to the Transcript.

Related information:

    Signal

Class protocol:

 initialize

self initialize

 iconInBrowserSymbol
( an extension from the stx:libtool package )

the browser will use this as index into the toolbariconlibrary

Instance protocol:

 title: aWarnBoxWindowTitle

an optional title for the warn box

 defaultAction

Default action for warnings: open a warn box with description

 showWarnDialog

open a warn box with description

Examples:

  Transcript showCR:'1 - now raising'.
  Warning raiseRequest.
  Transcript showCR:'2 - after the raise'.

  Warning raiseRequestErrorString:'hello world'

  Warning handle:[:ex |
      Transcript showCR:'WARNING: ' , ex description
  ] do:[
      '...'.
      Warning raiseRequest.
      '...'.
  ].

  Warning handle:[:ex |
      Transcript showCR:'WARNING: ' , ex description
  ] do:[
      '...'.
      Warning raiseRequestErrorString:'hello world'.
      '...'.
  ]

  Warning ignoreIn:[
      '...'.
      Warning raiseRequest.
      '...'.
  ]

  Warning deferAfter:[
      Transcript showCR:'1 - no warning here ...'.
      Warning raiseRequestErrorString:'this warning is deferred'.
      Transcript showCR:'2 - but in a second...'.
  ].
  Transcript showCR:'3 - after warning-protected block'.