ValModel.st
author claus
Tue, 16 May 1995 19:14:48 +0200
changeset 75 a53337dc3e19
parent 73 7b95459b18a6
child 86 38cc61653cb2
permissions -rw-r--r--
.
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
"
75
claus
parents: 73
diff changeset
    40
$Header: /cvs/stx/stx/libview2/Attic/ValModel.st,v 1.8 1995-05-16 17:14:27 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
69
claus
parents: 68
diff changeset
    67
!ValueModel methodsFor:'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
194eb0590b1e Initial revision
claus
parents:
diff changeset
    80
!ValueModel methodsFor:'accessing'!
194eb0590b1e Initial revision
claus
parents:
diff changeset
    81
69
claus
parents: 68
diff changeset
    82
value:anObject
73
claus
parents: 71
diff changeset
    83
    "set my value, if it changed, send change notifications to my dependents."
claus
parents: 71
diff changeset
    84
69
claus
parents: 68
diff changeset
    85
    |oldValue|
claus
parents: 68
diff changeset
    86
claus
parents: 68
diff changeset
    87
    oldValue := self value.
claus
parents: 68
diff changeset
    88
    self setValue:anObject.
claus
parents: 68
diff changeset
    89
    anObject ~= oldValue ifTrue:[
71
claus
parents: 70
diff changeset
    90
	self notifyChange:#value
69
claus
parents: 68
diff changeset
    91
    ]
claus
parents: 68
diff changeset
    92
!
claus
parents: 68
diff changeset
    93
claus
parents: 68
diff changeset
    94
accepted
claus
parents: 68
diff changeset
    95
    ^ accepted
claus
parents: 68
diff changeset
    96
!
claus
parents: 68
diff changeset
    97
62
194eb0590b1e Initial revision
claus
parents:
diff changeset
    98
accept
194eb0590b1e Initial revision
claus
parents:
diff changeset
    99
    accepted := true
194eb0590b1e Initial revision
claus
parents:
diff changeset
   100
!
194eb0590b1e Initial revision
claus
parents:
diff changeset
   101
194eb0590b1e Initial revision
claus
parents:
diff changeset
   102
value 
73
claus
parents: 71
diff changeset
   103
    "return my value"
claus
parents: 71
diff changeset
   104
claus
parents: 71
diff changeset
   105
    ^ self subclassResponsibility
62
194eb0590b1e Initial revision
claus
parents:
diff changeset
   106
!
194eb0590b1e Initial revision
claus
parents:
diff changeset
   107
194eb0590b1e Initial revision
claus
parents:
diff changeset
   108
setValue:newValue 
73
claus
parents: 71
diff changeset
   109
    "physically set my value, without change notifications"
claus
parents: 71
diff changeset
   110
claus
parents: 71
diff changeset
   111
    ^ self subclassResponsibility
69
claus
parents: 68
diff changeset
   112
! !
claus
parents: 68
diff changeset
   113
claus
parents: 68
diff changeset
   114
!ValueModel methodsFor:'initialization'!
claus
parents: 68
diff changeset
   115
claus
parents: 68
diff changeset
   116
initialize
claus
parents: 68
diff changeset
   117
    accepted := false
claus
parents: 68
diff changeset
   118
! !
claus
parents: 68
diff changeset
   119
claus
parents: 68
diff changeset
   120
!ValueModel methodsFor:'interrest'!
claus
parents: 68
diff changeset
   121
claus
parents: 68
diff changeset
   122
retractInterrestFor:someone
claus
parents: 68
diff changeset
   123
    "release interrest i.e. do no longer send changeMsg to changeReceiver
claus
parents: 68
diff changeset
   124
     iff someone is the changeReceiver.
claus
parents: 68
diff changeset
   125
     This can be used to (temporarily) turn off information sends,
claus
parents: 68
diff changeset
   126
     to break endless cycles (if two values change each other)"
claus
parents: 68
diff changeset
   127
claus
parents: 68
diff changeset
   128
    interrest notNil ifTrue:[
claus
parents: 68
diff changeset
   129
	interrest removeKey:someone ifAbsent:nil
claus
parents: 68
diff changeset
   130
    ]
62
194eb0590b1e Initial revision
claus
parents:
diff changeset
   131
!
194eb0590b1e Initial revision
claus
parents:
diff changeset
   132
69
claus
parents: 68
diff changeset
   133
onChangeSend:selector to:someone
claus
parents: 68
diff changeset
   134
    "add an interrest, arranging that
claus
parents: 68
diff changeset
   135
     a message with selector will be sent to someone 
claus
parents: 68
diff changeset
   136
     when my value changes."
62
194eb0590b1e Initial revision
claus
parents:
diff changeset
   137
69
claus
parents: 68
diff changeset
   138
    interrest isNil ifTrue:[
claus
parents: 68
diff changeset
   139
	interrest := IdentityDictionary new
claus
parents: 68
diff changeset
   140
    ].
claus
parents: 68
diff changeset
   141
    interrest at:someone put:selector
62
194eb0590b1e Initial revision
claus
parents:
diff changeset
   142
! !
194eb0590b1e Initial revision
claus
parents:
diff changeset
   143