InterestConverter.st
author |
Jan Vrany <jan.vrany@labware.com> |
|
Wed, 22 Mar 2023 13:57:18 +0000 |
branch | jv |
changeset 25445 |
1623217d2268 |
parent 18011 |
deb0c3355881
|
permissions |
-rw-r--r-- |
Cherry-picked OrderedCollection.st from 0b286fd51da7:
* d4c86d7c0bfc: #TUNING by stefan, Stefan Vogel <sv@exept.de>
* 692b6497a669: #DOCUMENTATION by stefan, Stefan Vogel <sv@exept.de>
* d47bb2912953: #DOCUMENTATION by stefan, Stefan Vogel <sv@exept.de>
* abb4316c6bff: #FEATURE by cg, Claus Gittinger <cg@exept.de>
* 3a8fce0e8d11: #TUNING by stefan, Stefan Vogel <sv@exept.de>
* 03d29bf8c5bb: #REFACTORING by stefan, Stefan Vogel <sv@exept.de>
* cccc6c4abcfc: #REFACTORING by stefan, Stefan Vogel <sv@exept.de>
* 35d957c7a840: #FEATURE by cg, Claus Gittinger <cg@exept.de>
* 6b11890f5f2c: #OTHER by cg, Claus Gittinger <cg@exept.de>
* abb6108fb06b: #FEATURE by cg, Claus Gittinger <cg@exept.de>
* 2c4768bb2e89: #FEATURE by cg, Claus Gittinger <cg@exept.de>
* 4029e964d0f1: #FEATURE by cg, Claus Gittinger <cg@exept.de>
* ddcab3a9c2df: #OTHER by cg, Claus Gittinger <cg@exept.de>
* 2213eb56e0c7: #REFACTORING by exept, Claus Gittinger <cg@exept.de>
* 09ca874a6160: #REFACTORING by exept, Claus Gittinger <cg@exept.de>
* 30b332af1f33: #BUGFIX by stefan, Stefan Vogel <sv@exept.de>
* 779764ba117b: #REFACTORING by cg, Claus Gittinger <cg@exept.de>
* b3d232a613c9: #BUGFIX by stefan, Stefan Vogel <sv@exept.de>
* c417f7edaec1: #BUGFIX by stefan, Stefan Vogel <sv@exept.de>
* 904b6538f379: #FEATURE by exept, Claus Gittinger <cg@exept.de>
* c5887f03e01f: #REFACTORING by stefan, Stefan Vogel <sv@exept.de>
* 8912d03aff48: #BUGFIX by exept, Claus Gittinger <cg@exept.de>
* de5cd1dab4c3: #DOCUMENTATION by exept, Claus Gittinger <cg@exept.de>
* 9bbd26603378: #OTHER by exept, Claus Gittinger <cg@exept.de>
* c2c9dc110f42: #FEATURE by stefan, Stefan Vogel <sv@exept.de>
* 81d123c6703d: #DOCUMENTATION by stefan, Stefan Vogel <sv@exept.de>
* 8aadbb21458a: #BUGFIX by stefan, Stefan Vogel <sv@exept.de>
* f210dbb8b2f6: #TUNING by stefan, Stefan Vogel <sv@exept.de>
* c2c774fc53c0: #FEATURE by exept, Claus Gittinger <cg@exept.de>
* b6f462670875: #DOCUMENTATION by exept, Claus Gittinger <cg@exept.de>
* 27ae4021d5d6: #FEATURE by stefan, Stefan Vogel <sv@exept.de>
* 10d9e9d85594: #TUNING by exept, Claus Gittinger <cg@exept.de>
* 2653d855dcc7: #DOCUMENTATION by exept, Claus Gittinger <cg@exept.de>
* 6ea1698a1a34: #FEATURE by stefan, Stefan Vogel <sv@exept.de>
* 28762315e664: #OTHER by exept, Claus Gittinger <cg@exept.de>
* 7142ea786f3e: #TUNING by stefan, Stefan Vogel <sv@exept.de>
* 7875acb42b53: #BUGFIX by stefan, Stefan Vogel <sv@exept.de>
* 163a0eebc97e: #BUGFIX by Maren, matilk
"
COPYRIGHT (c) 1996 by Claus Gittinger / 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.
"
"{ Package: 'stx:libbasic' }"
Object subclass:#InterestConverter
instanceVariableNames:'destination selector aspect'
classVariableNames:''
poolDictionaries:''
category:'Interface-Support-Models'
!
!InterestConverter class methodsFor:'documentation'!
copyright
"
COPYRIGHT (c) 1996 by Claus Gittinger / 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.
"
!
documentation
"
instances convert update messages into messages as setup via
#onChangeSend:to:.
This is a temporary kludge and will be replaced by a more intelligent
DependencyCollection class in the future.
[author:]
Claus Gittinger
"
!
examples
"
#onChangeSend:to / #retractInterestsIn:
interested in any change:
[exBegin]
|p b|
b := [Transcript showCR:'--> notification: point has changed'].
p := Point new.
p onChangeSend:#value to:b.
Delay waitForSeconds:1.
Transcript showCR:'sending change ...'.
p changed.
Transcript showCR:'retracting ...'.
p retractInterestsFor:b.
Delay waitForSeconds:1.
Transcript showCR:'sending change ...'.
p changed.
[exEnd]
#expressInterestIn:for:sendBack / #retractInterestIn:for:
interested in a specific change:
[exBegin]
|p b|
b := [Transcript showCR:'the point changed'].
p := Point new.
Transcript showCR:'interest in #foo'.
p expressInterestIn:#foo for:b sendBack:#value.
p x:1.
Transcript showCR:'now changing #bar'.
p changed:#bar.
Transcript cr.
Delay waitForSeconds:1.
Transcript showCR:'now changing #foo'.
p changed:#foo.
Transcript cr.
Delay waitForSeconds:1.
Transcript showCR:'no more interest in #foo'.
p retractInterestIn:#foo for:b.
Transcript showCR:'now changing #foo'.
p changed:#foo.
Transcript cr.
Delay waitForSeconds:1.
Transcript showCR:'interest in #bar now'.
p expressInterestIn:#bar for:b sendBack:#value.
Transcript showCR:'now changing #foo'.
p changed:#foo.
Transcript showCR:'now changing #bar'.
p changed:#bar.
Transcript cr.
Delay waitForSeconds:1.
Transcript showCR:'interest in #foo now'.
p expressInterestIn:#foo for:b sendBack:#value.
Transcript showCR:'now changing #foo'.
p changed:#foo.
Transcript showCR:'now changing #bar'.
p changed:#bar.
Transcript cr.
Delay waitForSeconds:1.
Transcript showCR:'no more interests'.
p retractInterestsFor:b.
Transcript showCR:'now changing #foo'.
p changed:#foo.
Transcript showCR:'now changing #bar'.
p changed:#bar.
Transcript cr.
[exEnd]
"
! !
!InterestConverter class methodsFor:'instance creation'!
destination:anObject selector:aSelector
"create & return an interestConverter, which sends aSelector
to anObject when a change notification arrives"
^ self basicNew destination:anObject selector:aSelector
"Modified: 21.5.1997 / 11:59:08 / cg"
!
destination:anObject selector:aSelector aspect:aspect
"create & return an interestConverter, which sends aSelector
to anObject when a change notification for aspect arrives"
^ self basicNew destination:anObject selector:aSelector aspect:aspect
"Modified: 21.5.1997 / 11:59:26 / cg"
! !
!InterestConverter methodsFor:'accessing'!
aspect
"return my aspect (if any)"
^ aspect
"Created: 8.3.1996 / 23:00:37 / cg"
"Modified: 21.5.1997 / 11:59:43 / cg"
!
destination
^ destination
"Created: 7.3.1996 / 10:57:01 / cg"
!
destination:dest selector:sel
destination := dest.
selector := sel
"Created: 7.3.1996 / 10:49:13 / cg"
!
destination:dest selector:sel aspect:a
destination := dest.
selector := sel.
aspect := a
"Created: 8.3.1996 / 22:42:03 / cg"
!
selector
^ selector
"Created: 7.3.1996 / 10:57:01 / cg"
! !
!InterestConverter methodsFor:'change & update'!
update:something with:aParameter from:someObject
(aspect isNil or:[aspect == something]) ifTrue:[
(selector numArgs) == 0 ifTrue:[
destination perform:selector
] ifFalse:[
destination perform:selector withOptionalArgument:something and:aParameter and:someObject
]
]
"Created: 7.3.1996 / 10:14:30 / cg"
"Modified: 8.3.1996 / 22:41:53 / cg"
! !
!InterestConverter methodsFor:'printing'!
displayOn:aGCOrStream
"Compatibility
append a printed desription on some stream (Dolphin, Squeak)
OR:
display the receiver in a graphicsContext at 0@0 (ST80).
This method allows for any object to be displayed in some view
(although the fallBack is to display its printString ...)"
"/ what a kludge - Dolphin and Squeak mean: printOn: a stream;
"/ ST/X (and some old ST80's) mean: draw-yourself on a GC.
aGCOrStream isStream ifFalse:[
^ super displayOn:aGCOrStream.
].
aGCOrStream
nextPutAll:self class name;
nextPutAll:'(sending '.
selector storeOn:aGCOrStream.
aGCOrStream nextPutAll:' to '.
destination printOn:aGCOrStream.
aGCOrStream nextPut:$).
! !
!InterestConverter methodsFor:'testing'!
isInterestConverter
^ true
! !
!InterestConverter class methodsFor:'documentation'!
version
^ '$Header: /cvs/stx/stx/libbasic/InterestConverter.st,v 1.16 2012-08-03 15:52:54 stefan Exp $'
! !