UserNotification.st
author Claus Gittinger <cg@exept.de>
Tue, 09 Jul 2019 20:55:17 +0200
changeset 24417 03b083548da2
parent 24022 b9b48b0f4875
permissions -rw-r--r--
#REFACTORING by exept class: Smalltalk class changed: #recursiveInstallAutoloadedClassesFrom:rememberIn:maxLevels:noAutoload:packageTop:showSplashInLevels: Transcript showCR:(... bindWith:...) -> Transcript showCR:... with:...
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
24022
b9b48b0f4875 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 16424
diff changeset
     1
"{ Encoding: utf8 }"
b9b48b0f4875 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 16424
diff changeset
     2
4549
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
     3
"
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
     4
 COPYRIGHT (c) 1999 by eXept Software AG
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
     5
              All Rights Reserved
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
     6
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
     7
 This software is furnished under a license and may be used
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
     8
 only in accordance with the terms of that license and with the
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
     9
 inclusion of the above copyright notice.   This software may not
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    10
 be provided or otherwise made available to, or used by, any
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    11
 other person.  No title to or ownership of the software is
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    12
 hereby transferred.
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    13
"
6206
59d1ec1e1ed5 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 5295
diff changeset
    14
"{ Package: 'stx:libbasic' }"
59d1ec1e1ed5 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 5295
diff changeset
    15
24022
b9b48b0f4875 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 16424
diff changeset
    16
"{ NameSpace: Smalltalk }"
b9b48b0f4875 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 16424
diff changeset
    17
12278
992ca2a1e9a6 inheritance changed: Notification handle... will now also handle
Claus Gittinger <cg@exept.de>
parents: 11615
diff changeset
    18
Notification subclass:#UserNotification
4549
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    19
	instanceVariableNames:''
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    20
	classVariableNames:''
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    21
	poolDictionaries:''
11198
090a44ec1648 category
Claus Gittinger <cg@exept.de>
parents: 10823
diff changeset
    22
	category:'Kernel-Exceptions-Notifications'
4549
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    23
!
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    24
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    25
!UserNotification class methodsFor:'documentation'!
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    26
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    27
copyright
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    28
"
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    29
 COPYRIGHT (c) 1999 by eXept Software AG
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    30
              All Rights Reserved
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    31
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    32
 This software is furnished under a license and may be used
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    33
 only in accordance with the terms of that license and with the
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    34
 inclusion of the above copyright notice.   This software may not
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    35
 be provided or otherwise made available to, or used by, any
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    36
 other person.  No title to or ownership of the software is
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    37
 hereby transferred.
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    38
"
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    39
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    40
!
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    41
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    42
documentation
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    43
"    
7038
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 7032
diff changeset
    44
    UserNotification is the superclass of all user notification 
12278
992ca2a1e9a6 inheritance changed: Notification handle... will now also handle
Claus Gittinger <cg@exept.de>
parents: 11615
diff changeset
    45
    signals in the system. It produces an info box with the message on the screen. 
11198
090a44ec1648 category
Claus Gittinger <cg@exept.de>
parents: 10823
diff changeset
    46
    If no display is available, the message is written to the Transcript (headless operation).
4549
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    47
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    48
    [author:]
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    49
        Stefan Vogel
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    50
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    51
    [see also:]
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    52
        Signal
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    53
"
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    54
!
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    55
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    56
examples
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    57
"
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    58
                                                            [exBegin]
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    59
    UserNotification raiseRequest
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    60
                                                            [exEnd]
4554
db264efac2c0 Add copyright.
Stefan Vogel <sv@exept.de>
parents: 4549
diff changeset
    61
db264efac2c0 Add copyright.
Stefan Vogel <sv@exept.de>
parents: 4549
diff changeset
    62
                                                            [exBegin]
10814
31ca937978d7 comment
Claus Gittinger <cg@exept.de>
parents: 10516
diff changeset
    63
    UserNotification raiseErrorString:'huh ?'
31ca937978d7 comment
Claus Gittinger <cg@exept.de>
parents: 10516
diff changeset
    64
                                                            [exEnd]
31ca937978d7 comment
Claus Gittinger <cg@exept.de>
parents: 10516
diff changeset
    65
31ca937978d7 comment
Claus Gittinger <cg@exept.de>
parents: 10516
diff changeset
    66
                                                            [exBegin]
4554
db264efac2c0 Add copyright.
Stefan Vogel <sv@exept.de>
parents: 4549
diff changeset
    67
    UserNotification raiseRequestWith:nil errorString:'what ?'
db264efac2c0 Add copyright.
Stefan Vogel <sv@exept.de>
parents: 4549
diff changeset
    68
                                                            [exEnd]
db264efac2c0 Add copyright.
Stefan Vogel <sv@exept.de>
parents: 4549
diff changeset
    69
db264efac2c0 Add copyright.
Stefan Vogel <sv@exept.de>
parents: 4549
diff changeset
    70
                                                            [exBegin]
db264efac2c0 Add copyright.
Stefan Vogel <sv@exept.de>
parents: 4549
diff changeset
    71
    UserNotification raiseRequestWith:nil errorString:' what ?'
db264efac2c0 Add copyright.
Stefan Vogel <sv@exept.de>
parents: 4549
diff changeset
    72
                                                            [exEnd]
4549
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    73
"
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    74
! !
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    75
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    76
!UserNotification class methodsFor:'initialization'!
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    77
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    78
initialize
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    79
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    80
    NotifierString := 'User Notification:'.
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    81
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    82
    "
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    83
     self initialize
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    84
    "
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    85
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    86
    "Created: / 23.7.1999 / 15:31:44 / stefan"
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    87
! !
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
    88
10823
a2efd924729a +notify:
Claus Gittinger <cg@exept.de>
parents: 10814
diff changeset
    89
!UserNotification class methodsFor:'notification'!
a2efd924729a +notify:
Claus Gittinger <cg@exept.de>
parents: 10814
diff changeset
    90
a2efd924729a +notify:
Claus Gittinger <cg@exept.de>
parents: 10814
diff changeset
    91
notify:aString
14554
246cb9b21fdc class: UserNotification
Stefan Vogel <sv@exept.de>
parents: 14270
diff changeset
    92
    self raiseRequestErrorString:aString
14270
97d89811ce9f added: #notify:progress:
vrany
parents: 12278
diff changeset
    93
!
97d89811ce9f added: #notify:progress:
vrany
parents: 12278
diff changeset
    94
14554
246cb9b21fdc class: UserNotification
Stefan Vogel <sv@exept.de>
parents: 14270
diff changeset
    95
notify:message progress:progress
246cb9b21fdc class: UserNotification
Stefan Vogel <sv@exept.de>
parents: 14270
diff changeset
    96
    ^ ProgressNotification notify:message progress:progress
14270
97d89811ce9f added: #notify:progress:
vrany
parents: 12278
diff changeset
    97
97d89811ce9f added: #notify:progress:
vrany
parents: 12278
diff changeset
    98
    "Created: / 31-07-2012 / 15:18:13 / Jan Vrany <jan.vrany@fit.cvut.cz>"
10823
a2efd924729a +notify:
Claus Gittinger <cg@exept.de>
parents: 10814
diff changeset
    99
! !
a2efd924729a +notify:
Claus Gittinger <cg@exept.de>
parents: 10814
diff changeset
   100
4549
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   101
!UserNotification methodsFor:'default actions'!
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   102
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   103
defaultAction
5295
f144309dab04 #errorString --> #description
Stefan Vogel <sv@exept.de>
parents: 4554
diff changeset
   104
    "Default action for notifications: open a info box with description"
4549
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   105
16424
62362daa8178 class: UserNotification
Claus Gittinger <cg@exept.de>
parents: 14949
diff changeset
   106
    self showInformationDialog.
62362daa8178 class: UserNotification
Claus Gittinger <cg@exept.de>
parents: 14949
diff changeset
   107
    self proceed.
62362daa8178 class: UserNotification
Claus Gittinger <cg@exept.de>
parents: 14949
diff changeset
   108
62362daa8178 class: UserNotification
Claus Gittinger <cg@exept.de>
parents: 14949
diff changeset
   109
    "
62362daa8178 class: UserNotification
Claus Gittinger <cg@exept.de>
parents: 14949
diff changeset
   110
      UserNotification raiseRequestErrorString:' abc'
62362daa8178 class: UserNotification
Claus Gittinger <cg@exept.de>
parents: 14949
diff changeset
   111
    "
62362daa8178 class: UserNotification
Claus Gittinger <cg@exept.de>
parents: 14949
diff changeset
   112
62362daa8178 class: UserNotification
Claus Gittinger <cg@exept.de>
parents: 14949
diff changeset
   113
    "Modified: / 3.8.1999 / 14:06:55 / stefan"
62362daa8178 class: UserNotification
Claus Gittinger <cg@exept.de>
parents: 14949
diff changeset
   114
!
62362daa8178 class: UserNotification
Claus Gittinger <cg@exept.de>
parents: 14949
diff changeset
   115
62362daa8178 class: UserNotification
Claus Gittinger <cg@exept.de>
parents: 14949
diff changeset
   116
showInformationDialog
62362daa8178 class: UserNotification
Claus Gittinger <cg@exept.de>
parents: 14949
diff changeset
   117
    "open a info box with description"
62362daa8178 class: UserNotification
Claus Gittinger <cg@exept.de>
parents: 14949
diff changeset
   118
4549
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   119
    |text|
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   120
5295
f144309dab04 #errorString --> #description
Stefan Vogel <sv@exept.de>
parents: 4554
diff changeset
   121
    text := self description.
4549
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   122
24022
b9b48b0f4875 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 16424
diff changeset
   123
    (self suppressDialogIfUnhandled not and:[self hasDialog]) ifTrue:[
7032
3c0246b4e602 Now Warning is a subclass of UserNotification.
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
   124
        Dialog information:text.
4549
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   125
    ] ifFalse:[
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   126
        "
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   127
         on systems without GUI, simply show
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   128
         the message on the Transcript.
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   129
        "
24022
b9b48b0f4875 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 16424
diff changeset
   130
        Transcript show:(self class name); show:': '; showCR:text.
4549
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   131
    ].
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   132
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   133
    "
7032
3c0246b4e602 Now Warning is a subclass of UserNotification.
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
   134
      UserNotification raiseRequestErrorString:' abc'
4549
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   135
    "
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   136
24022
b9b48b0f4875 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 16424
diff changeset
   137
    "Modified: / 03-08-1999 / 14:06:55 / stefan"
b9b48b0f4875 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 16424
diff changeset
   138
    "Modified: / 29-03-2019 / 10:55:25 / Claus Gittinger"
4549
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   139
! !
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   140
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   141
!UserNotification class methodsFor:'documentation'!
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   142
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   143
version
24022
b9b48b0f4875 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 16424
diff changeset
   144
    ^ '$Header$'
12278
992ca2a1e9a6 inheritance changed: Notification handle... will now also handle
Claus Gittinger <cg@exept.de>
parents: 11615
diff changeset
   145
!
992ca2a1e9a6 inheritance changed: Notification handle... will now also handle
Claus Gittinger <cg@exept.de>
parents: 11615
diff changeset
   146
992ca2a1e9a6 inheritance changed: Notification handle... will now also handle
Claus Gittinger <cg@exept.de>
parents: 11615
diff changeset
   147
version_CVS
24022
b9b48b0f4875 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 16424
diff changeset
   148
    ^ '$Header$'
4549
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   149
! !
7032
3c0246b4e602 Now Warning is a subclass of UserNotification.
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
   150
14949
db71d89dd7f3 class: UserNotification
Claus Gittinger <cg@exept.de>
parents: 14554
diff changeset
   151
4549
91a47cb22ba4 initial checkin
Stefan Vogel <sv@exept.de>
parents:
diff changeset
   152
UserNotification initialize!