Class: UserNotification

• Inheritance
• Description
• Class protocol
  • accessing
  • helpers
  • notification
• Instance protocol
  • default actions
  • testing
• Examples

Inheritance:

   Object
   |
   +--GenericException
      |
      +--Notification
         |
         +--UserNotification
            |
            +--ActivityNotification
            |
            +--UserInformation
            |
            +--Warning

Package:

stx:libbasic

Category:

Kernel-Exceptions-Notifications

Version:

rev: 1.26 date: 2022/03/11 12:24:53

user: stefan

file: UserNotification.st directory: libbasic

module: stx stc-classLibrary: libbasic

Description:

UserNotification is the superclass of all user notification signals in the system. 
It produces an info box with the message on the screen. 
If no display is available, the message is logged (headless operation).

This allows for non-GUI model code to provide user notifications which are optionally shown.
Very useful, for example to provide progress information from a method which can be
invoked both from a GUI-Tool (where notifications are wanted) and also from the system,
where such notifications are not desired.

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

 hasDialog

answer true, if we can use a Dialog window

 notify: aString

(comment from inherited method)
raise the query - return the handler's value, or the default
value, if there is no handler.

 notify: message progress: progress

Instance protocol:

 defaultAction

Default action for notifications: open a info box with description

 showInformationDialog

open a info box with description

 suppressDialogIfUnhandled

controls if a dialog is to be shown
in the default action when unhandled, or not.
Can be redefined by subclasses

Examples:

    UserNotification raiseRequest

    UserNotification raiseErrorString:'huh ?'

    UserNotification raiseRequestWith:nil errorString:'what ?'

    UserNotification raiseRequestWith:nil errorString:' what ?'