ValueModel.st
author Claus Gittinger <cg@exept.de>
Sun, 29 Oct 1995 20:36:22 +0100
changeset 109 9e1383121df4
parent 96 948318b2fbd4
child 114 e577a2f332d0
permissions -rw-r--r--
*** empty log message ***
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
75
claus
parents: 73
diff changeset
     1
"
claus
parents: 73
diff changeset
     2
 COPYRIGHT (c) 1995 by Claus Gittinger
claus
parents: 73
diff changeset
     3
	      All Rights Reserved
claus
parents: 73
diff changeset
     4
claus
parents: 73
diff changeset
     5
 This software is furnished under a license and may be used
claus
parents: 73
diff changeset
     6
 only in accordance with the terms of that license and with the
claus
parents: 73
diff changeset
     7
 inclusion of the above copyright notice.   This software may not
claus
parents: 73
diff changeset
     8
 be provided or otherwise made available to, or used by, any
claus
parents: 73
diff changeset
     9
 other person.  No title to or ownership of the software is
claus
parents: 73
diff changeset
    10
 hereby transferred.
claus
parents: 73
diff changeset
    11
"
claus
parents: 73
diff changeset
    12
69
claus
parents: 68
diff changeset
    13
'From Smalltalk/X, Version:2.10.5 on 9-may-1995 at 12:03:02 pm'!
claus
parents: 68
diff changeset
    14
claus
parents: 68
diff changeset
    15
Model subclass:#ValueModel
claus
parents: 68
diff changeset
    16
	 instanceVariableNames:'accepted interrest'
62
194eb0590b1e Initial revision
claus
parents:
diff changeset
    17
	 classVariableNames:''
194eb0590b1e Initial revision
claus
parents:
diff changeset
    18
	 poolDictionaries:''
71
claus
parents: 70
diff changeset
    19
	 category:'Interface-Support-Models'
62
194eb0590b1e Initial revision
claus
parents:
diff changeset
    20
!
194eb0590b1e Initial revision
claus
parents:
diff changeset
    21
68
claus
parents: 66
diff changeset
    22
!ValueModel class methodsFor:'documentation'!
claus
parents: 66
diff changeset
    23
69
claus
parents: 68
diff changeset
    24
copyright
claus
parents: 68
diff changeset
    25
"
claus
parents: 68
diff changeset
    26
 COPYRIGHT (c) 1995 by Claus Gittinger
71
claus
parents: 70
diff changeset
    27
	      All Rights Reserved
69
claus
parents: 68
diff changeset
    28
claus
parents: 68
diff changeset
    29
 This software is furnished under a license and may be used
claus
parents: 68
diff changeset
    30
 only in accordance with the terms of that license and with the
claus
parents: 68
diff changeset
    31
 inclusion of the above copyright notice.   This software may not
claus
parents: 68
diff changeset
    32
 be provided or otherwise made available to, or used by, any
claus
parents: 68
diff changeset
    33
 other person.  No title to or ownership of the software is
claus
parents: 68
diff changeset
    34
 hereby transferred.
claus
parents: 68
diff changeset
    35
"
claus
parents: 68
diff changeset
    36
!
claus
parents: 68
diff changeset
    37
claus
parents: 68
diff changeset
    38
version
claus
parents: 68
diff changeset
    39
"
96
claus
parents: 86
diff changeset
    40
$Header: /cvs/stx/stx/libview2/ValueModel.st,v 1.10 1995-08-29 17:45:21 claus Exp $
69
claus
parents: 68
diff changeset
    41
"
claus
parents: 68
diff changeset
    42
!
claus
parents: 68
diff changeset
    43
68
claus
parents: 66
diff changeset
    44
documentation
claus
parents: 66
diff changeset
    45
"
claus
parents: 66
diff changeset
    46
    abstract superclass for ValueHolders and Adaptors.
69
claus
parents: 68
diff changeset
    47
    It does not itself know how and where the value is stored,
claus
parents: 68
diff changeset
    48
    but knows about interrested objects (which get informed, whenever
claus
parents: 68
diff changeset
    49
    the value changes) and keeps track if the value was ever accepted.
68
claus
parents: 66
diff changeset
    50
claus
parents: 66
diff changeset
    51
    Notice: this class was implemented using protocol information
claus
parents: 66
diff changeset
    52
    from alpha testers - it may not be complete or compatible to
claus
parents: 66
diff changeset
    53
    the corresponding ST-80 class. If you encounter any incompatibilities,
claus
parents: 66
diff changeset
    54
    please forward a note to the ST/X team.
69
claus
parents: 68
diff changeset
    55
claus
parents: 68
diff changeset
    56
    subclasses must redefine: #setValue: and #value
claus
parents: 68
diff changeset
    57
    (and optionally redefine #value:)
68
claus
parents: 66
diff changeset
    58
"
claus
parents: 66
diff changeset
    59
! !
claus
parents: 66
diff changeset
    60
62
194eb0590b1e Initial revision
claus
parents:
diff changeset
    61
!ValueModel class methodsFor:'instance creation'!
194eb0590b1e Initial revision
claus
parents:
diff changeset
    62
194eb0590b1e Initial revision
claus
parents:
diff changeset
    63
new
194eb0590b1e Initial revision
claus
parents:
diff changeset
    64
    ^ (super new) initialize
194eb0590b1e Initial revision
claus
parents:
diff changeset
    65
! !
194eb0590b1e Initial revision
claus
parents:
diff changeset
    66
86
claus
parents: 75
diff changeset
    67
!ValueModel ignoredMethodsFor:'change notification'!
62
194eb0590b1e Initial revision
claus
parents:
diff changeset
    68
69
claus
parents: 68
diff changeset
    69
notifyChange:aSymbol
73
claus
parents: 71
diff changeset
    70
    "notify my dependents and those that are interrested"
claus
parents: 71
diff changeset
    71
69
claus
parents: 68
diff changeset
    72
    interrest notNil ifTrue:[
71
claus
parents: 70
diff changeset
    73
	interrest keysAndValuesDo:[:someone :selector |
claus
parents: 70
diff changeset
    74
	    someone perform:selector
claus
parents: 70
diff changeset
    75
	].
69
claus
parents: 68
diff changeset
    76
    ].
claus
parents: 68
diff changeset
    77
    self changed:aSymbol
62
194eb0590b1e Initial revision
claus
parents:
diff changeset
    78
! !
194eb0590b1e Initial revision
claus
parents:
diff changeset
    79
86
claus
parents: 75
diff changeset
    80
!ValueModel methodsFor:'change notification'!
claus
parents: 75
diff changeset
    81
claus
parents: 75
diff changeset
    82
changed:aSymbol
claus
parents: 75
diff changeset
    83
    "notify my dependents and those that are interrested"
claus
parents: 75
diff changeset
    84
claus
parents: 75
diff changeset
    85
    interrest notNil ifTrue:[
claus
parents: 75
diff changeset
    86
	interrest keysAndValuesDo:[:someone :selector |
claus
parents: 75
diff changeset
    87
	    someone perform:selector
claus
parents: 75
diff changeset
    88
	].
claus
parents: 75
diff changeset
    89
    ].
claus
parents: 75
diff changeset
    90
    super changed:aSymbol
claus
parents: 75
diff changeset
    91
! !
claus
parents: 75
diff changeset
    92
62
194eb0590b1e Initial revision
claus
parents:
diff changeset
    93
!ValueModel methodsFor:'accessing'!
194eb0590b1e Initial revision
claus
parents:
diff changeset
    94
69
claus
parents: 68
diff changeset
    95
value:anObject
73
claus
parents: 71
diff changeset
    96
    "set my value, if it changed, send change notifications to my dependents."
claus
parents: 71
diff changeset
    97
69
claus
parents: 68
diff changeset
    98
    |oldValue|
claus
parents: 68
diff changeset
    99
claus
parents: 68
diff changeset
   100
    oldValue := self value.
claus
parents: 68
diff changeset
   101
    self setValue:anObject.
claus
parents: 68
diff changeset
   102
    anObject ~= oldValue ifTrue:[
86
claus
parents: 75
diff changeset
   103
	"/ self notifyChange:#value
claus
parents: 75
diff changeset
   104
	self changed:#value
69
claus
parents: 68
diff changeset
   105
    ]
claus
parents: 68
diff changeset
   106
!
claus
parents: 68
diff changeset
   107
claus
parents: 68
diff changeset
   108
accepted
claus
parents: 68
diff changeset
   109
    ^ accepted
claus
parents: 68
diff changeset
   110
!
claus
parents: 68
diff changeset
   111
62
194eb0590b1e Initial revision
claus
parents:
diff changeset
   112
accept
194eb0590b1e Initial revision
claus
parents:
diff changeset
   113
    accepted := true
194eb0590b1e Initial revision
claus
parents:
diff changeset
   114
!
194eb0590b1e Initial revision
claus
parents:
diff changeset
   115
194eb0590b1e Initial revision
claus
parents:
diff changeset
   116
value 
73
claus
parents: 71
diff changeset
   117
    "return my value"
claus
parents: 71
diff changeset
   118
claus
parents: 71
diff changeset
   119
    ^ self subclassResponsibility
62
194eb0590b1e Initial revision
claus
parents:
diff changeset
   120
!
194eb0590b1e Initial revision
claus
parents:
diff changeset
   121
194eb0590b1e Initial revision
claus
parents:
diff changeset
   122
setValue:newValue 
73
claus
parents: 71
diff changeset
   123
    "physically set my value, without change notifications"
claus
parents: 71
diff changeset
   124
claus
parents: 71
diff changeset
   125
    ^ self subclassResponsibility
69
claus
parents: 68
diff changeset
   126
! !
claus
parents: 68
diff changeset
   127
claus
parents: 68
diff changeset
   128
!ValueModel methodsFor:'initialization'!
claus
parents: 68
diff changeset
   129
claus
parents: 68
diff changeset
   130
initialize
claus
parents: 68
diff changeset
   131
    accepted := false
claus
parents: 68
diff changeset
   132
! !
claus
parents: 68
diff changeset
   133
claus
parents: 68
diff changeset
   134
!ValueModel methodsFor:'interrest'!
claus
parents: 68
diff changeset
   135
claus
parents: 68
diff changeset
   136
retractInterrestFor:someone
claus
parents: 68
diff changeset
   137
    "release interrest i.e. do no longer send changeMsg to changeReceiver
claus
parents: 68
diff changeset
   138
     iff someone is the changeReceiver.
claus
parents: 68
diff changeset
   139
     This can be used to (temporarily) turn off information sends,
claus
parents: 68
diff changeset
   140
     to break endless cycles (if two values change each other)"
claus
parents: 68
diff changeset
   141
claus
parents: 68
diff changeset
   142
    interrest notNil ifTrue:[
claus
parents: 68
diff changeset
   143
	interrest removeKey:someone ifAbsent:nil
claus
parents: 68
diff changeset
   144
    ]
62
194eb0590b1e Initial revision
claus
parents:
diff changeset
   145
!
194eb0590b1e Initial revision
claus
parents:
diff changeset
   146
69
claus
parents: 68
diff changeset
   147
onChangeSend:selector to:someone
claus
parents: 68
diff changeset
   148
    "add an interrest, arranging that
claus
parents: 68
diff changeset
   149
     a message with selector will be sent to someone 
claus
parents: 68
diff changeset
   150
     when my value changes."
62
194eb0590b1e Initial revision
claus
parents:
diff changeset
   151
69
claus
parents: 68
diff changeset
   152
    interrest isNil ifTrue:[
claus
parents: 68
diff changeset
   153
	interrest := IdentityDictionary new
claus
parents: 68
diff changeset
   154
    ].
claus
parents: 68
diff changeset
   155
    interrest at:someone put:selector
62
194eb0590b1e Initial revision
claus
parents:
diff changeset
   156
! !
194eb0590b1e Initial revision
claus
parents:
diff changeset
   157