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