eXept Software AG Logo

Smalltalk/X Webserver

Documentation of class 'UserConfirmation':

Home

Documentation
www.exept.de
Everywhere
for:
[back]

Class: UserConfirmation


Inheritance:

   Object
   |
   +--GenericException
      |
      +--Notification
         |
         +--UserConfirmation
            |
            +--ProvideAnswerNotification

Package:
stx:libbasic
Category:
Kernel-Exceptions-Notifications
Version:
rev: 1.9 date: 2016/06/03 12:16:11
user: sr
file: UserConfirmation.st directory: libbasic
module: stx stc-classLibrary: libbasic
Author:
Stefan Vogel
Claus Gittinger

Description:


This confirmation query is used when a user confirmation is required
somewhere within a model's operation (i.e. in non-GUI code).
Instead of directly asking via Dialog confirm... messages,
this should be raised.
Its default behavior is the same as the above dialog.
However, the query can be caught and answered by an exceoptn (a query-) handler,
to suppress these GUI interactions in situations, where they are not wanted.

This is a much better approach to the alternatives:
    passing additional 'doConfirm' arguments down from the high level caller
    keeping the doConfirm settings in a passed down flag object
    keeping the flag in a global (very bad)
    keeping it in a class var (almost as bad)

Notice: that's one of the nice consequences of proceedable exceptions.


Related information:

    Query
    Notification
    Exception

Instance protocol:

accessing
o  aspect
the aspect the user is asked. Set this to a symbol.
It can be used by a exception handler

o  aspect: aSymbol
the aspect the user is asked. Set this to a symbol.
It can be used by a exception handler

o  canCancel
answer true, if the user is allowed to press the cancel button
in a confirmation dialog

o  canCancel: something

o  defaultAnswer
used to pass information from the raiser to the GUI dialog.
Specifies, which answer of the three (yes/no/cancel) should be the return-key-default.
If not specified, the cancel-key will be the default

o  defaultAnswer: aBooleanOrNil
used to pass information from the raiser to the GUI dialog.
Specifies, which answer of the three (yes/no/cancel) should be the return-key-default.
If not specified, the cancel-key will be the default

default actions
o  defaultAction
Default action for confirmations: open a info box with description.
If no GUI present, assume that the user pressed 'yes'

queries
o  askingContext
return the context which did the confirm-request



ST/X 7.2.0.0; WebServer 1.670 at bd0aa1f87cdd.unknown:8081; Thu, 28 Mar 2024 19:31:01 GMT