Class: Warning

• Inheritance
• Description
• Class protocol
  • accessing
  • 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.28 date: 2023/05/24 08:34:44

user: stefan

file: Warning.st directory: libbasic

module: stx stc-classLibrary: libbasic

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.

copyright
COPYRIGHT (c) 1999 by eXept Software AG
             All Rights Reserved

This software is furnished under a license and may be used
only in accordance with the terms of that license and with the
inclusion of the above copyright notice.   This software may not
be provided or otherwise made available to, or used by, any
other person.  No title to or ownership of the software is
hereby transferred.

Class protocol:

 defaultNotifierString

 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'.