Model.st
author Claus Gittinger <cg@exept.de>
Thu, 23 Nov 1995 11:43:41 +0100
changeset 125 fa5b5e4336bf
parent 114 e577a2f332d0
child 129 f890eaabc487
permissions -rw-r--r--
checkin from browser
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
3f9277473954 Initial revision
claus
parents:
diff changeset
     1
"
6
4ac87e6bf82f *** empty log message ***
claus
parents: 5
diff changeset
     2
 COPYRIGHT (c) 1992 by Claus Gittinger
35
f13cdd0b44c7 *** empty log message ***
claus
parents: 28
diff changeset
     3
	      All Rights Reserved
0
3f9277473954 Initial revision
claus
parents:
diff changeset
     4
3f9277473954 Initial revision
claus
parents:
diff changeset
     5
 This software is furnished under a license and may be used
3f9277473954 Initial revision
claus
parents:
diff changeset
     6
 only in accordance with the terms of that license and with the
3f9277473954 Initial revision
claus
parents:
diff changeset
     7
 inclusion of the above copyright notice.   This software may not
3f9277473954 Initial revision
claus
parents:
diff changeset
     8
 be provided or otherwise made available to, or used by, any
3f9277473954 Initial revision
claus
parents:
diff changeset
     9
 other person.  No title to or ownership of the software is
3f9277473954 Initial revision
claus
parents:
diff changeset
    10
 hereby transferred.
3f9277473954 Initial revision
claus
parents:
diff changeset
    11
"
3f9277473954 Initial revision
claus
parents:
diff changeset
    12
3f9277473954 Initial revision
claus
parents:
diff changeset
    13
Object subclass:#Model
125
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    14
	 instanceVariableNames:'dependents'
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    15
	 classVariableNames:''
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    16
	 poolDictionaries:''
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    17
	 category:'Interface-Support-Models'
0
3f9277473954 Initial revision
claus
parents:
diff changeset
    18
!
3f9277473954 Initial revision
claus
parents:
diff changeset
    19
21
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    20
!Model class methodsFor:'documentation'!
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    21
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    22
copyright
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    23
"
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    24
 COPYRIGHT (c) 1992 by Claus Gittinger
35
f13cdd0b44c7 *** empty log message ***
claus
parents: 28
diff changeset
    25
	      All Rights Reserved
0
3f9277473954 Initial revision
claus
parents:
diff changeset
    26
21
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    27
 This software is furnished under a license and may be used
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    28
 only in accordance with the terms of that license and with the
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    29
 inclusion of the above copyright notice.   This software may not
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    30
 be provided or otherwise made available to, or used by, any
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    31
 other person.  No title to or ownership of the software is
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    32
 hereby transferred.
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    33
"
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    34
!
0
3f9277473954 Initial revision
claus
parents:
diff changeset
    35
21
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    36
documentation
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    37
"
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    38
    Models are things that are presented in views. Instances keep track of 
35
f13cdd0b44c7 *** empty log message ***
claus
parents: 28
diff changeset
    39
    which views are dependent of them and inform them of any changes.
87
claus
parents: 83
diff changeset
    40
    Actually the Model class is not really needed; since the dependency
claus
parents: 83
diff changeset
    41
    mechanism is inherited by Object, you can take any object as a model.
claus
parents: 83
diff changeset
    42
    However, instances of Model (and subclasses) keep the dependents locally
35
f13cdd0b44c7 *** empty log message ***
claus
parents: 28
diff changeset
    43
    in an instance variable; thus speeding up access a bit.
f13cdd0b44c7 *** empty log message ***
claus
parents: 28
diff changeset
    44
21
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    45
    Instance variables:
87
claus
parents: 83
diff changeset
    46
	dependents      Collection      those objects which depend on me.
claus
parents: 83
diff changeset
    47
					To save some storage, the dependent is
claus
parents: 83
diff changeset
    48
					kept directly here, IFF there os only one.
claus
parents: 83
diff changeset
    49
					Otherwise, a collection of dependents is
claus
parents: 83
diff changeset
    50
					held here.
21
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    51
"
125
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    52
!
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    53
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    54
version
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    55
    ^ '$Header: /cvs/stx/stx/libview2/Model.st,v 1.16 1995-11-23 10:42:21 cg Exp $'
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    56
! !
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    57
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    58
!Model methodsFor:'copying'!
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    59
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    60
postCopy
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    61
    "release dependents after copying"
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    62
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    63
    self dependents:nil
21
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    64
! !
0
3f9277473954 Initial revision
claus
parents:
diff changeset
    65
83
claus
parents: 71
diff changeset
    66
!Model methodsFor:'dependents access'!
0
3f9277473954 Initial revision
claus
parents:
diff changeset
    67
83
claus
parents: 71
diff changeset
    68
addDependent:anObject
claus
parents: 71
diff changeset
    69
    "make the argument, anObject be a dependent of the receiver"
claus
parents: 71
diff changeset
    70
claus
parents: 71
diff changeset
    71
    |deps|
claus
parents: 71
diff changeset
    72
claus
parents: 71
diff changeset
    73
    deps := dependents.
claus
parents: 71
diff changeset
    74
    deps isNil ifTrue:[
claus
parents: 71
diff changeset
    75
	dependents := anObject
claus
parents: 71
diff changeset
    76
    ] ifFalse:[
claus
parents: 71
diff changeset
    77
	(deps isMemberOf:IdentitySet) ifTrue:[
claus
parents: 71
diff changeset
    78
	    deps add:anObject
claus
parents: 71
diff changeset
    79
	] ifFalse:[
claus
parents: 71
diff changeset
    80
	    dependents := IdentitySet with:dependents with:anObject
claus
parents: 71
diff changeset
    81
	]
claus
parents: 71
diff changeset
    82
    ]
claus
parents: 71
diff changeset
    83
!
claus
parents: 71
diff changeset
    84
125
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    85
dependents
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    86
    "return a Collection of dependents - nil if there is none"
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    87
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    88
    ^ dependents
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    89
!
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    90
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    91
dependents:aCollection
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    92
    "set the collection of dependents"
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    93
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    94
    dependents := aCollection
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    95
!
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    96
83
claus
parents: 71
diff changeset
    97
dependentsDo:aBlock
claus
parents: 71
diff changeset
    98
    "evaluate aBlock for all of my dependents"
claus
parents: 71
diff changeset
    99
claus
parents: 71
diff changeset
   100
    |deps|
claus
parents: 71
diff changeset
   101
claus
parents: 71
diff changeset
   102
    deps := dependents.
claus
parents: 71
diff changeset
   103
    deps notNil ifTrue:[
claus
parents: 71
diff changeset
   104
	(deps isMemberOf:IdentitySet) ifTrue:[
claus
parents: 71
diff changeset
   105
	    deps do:aBlock
claus
parents: 71
diff changeset
   106
	] ifFalse:[
claus
parents: 71
diff changeset
   107
	    aBlock value:deps
claus
parents: 71
diff changeset
   108
	]
claus
parents: 71
diff changeset
   109
    ]
claus
parents: 71
diff changeset
   110
!
claus
parents: 71
diff changeset
   111
125
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   112
release
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   113
    dependents := nil
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   114
!
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   115
83
claus
parents: 71
diff changeset
   116
removeDependent:anObject
claus
parents: 71
diff changeset
   117
    "make the argument, anObject be independent of the receiver"
claus
parents: 71
diff changeset
   118
claus
parents: 71
diff changeset
   119
    |deps sz|
claus
parents: 71
diff changeset
   120
claus
parents: 71
diff changeset
   121
    deps := dependents.
claus
parents: 71
diff changeset
   122
    deps notNil ifTrue:[
claus
parents: 71
diff changeset
   123
	(deps isMemberOf:IdentitySet) ifTrue:[
claus
parents: 71
diff changeset
   124
	    deps remove:anObject ifAbsent:[].
claus
parents: 71
diff changeset
   125
	    (sz := deps size) == 1 ifTrue:[
claus
parents: 71
diff changeset
   126
		dependents := deps first
claus
parents: 71
diff changeset
   127
	    ] ifFalse:[
claus
parents: 71
diff changeset
   128
		(sz == 0) ifTrue:[
claus
parents: 71
diff changeset
   129
		    dependents := nil
claus
parents: 71
diff changeset
   130
		]
claus
parents: 71
diff changeset
   131
	    ]
claus
parents: 71
diff changeset
   132
	] ifFalse:[
claus
parents: 71
diff changeset
   133
	    dependents := nil
claus
parents: 71
diff changeset
   134
	]
claus
parents: 71
diff changeset
   135
    ]
0
3f9277473954 Initial revision
claus
parents:
diff changeset
   136
! !
3f9277473954 Initial revision
claus
parents:
diff changeset
   137
125
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   138
!Model methodsFor:'drawing'!
28
8daff0234d2e *** empty log message ***
claus
parents: 23
diff changeset
   139
125
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   140
displayOn:aGraphicsContext
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   141
    "display myself in aGraphicsContext"
28
8daff0234d2e *** empty log message ***
claus
parents: 23
diff changeset
   142
125
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   143
    ^ self subclassResponsibility
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   144
!
0
3f9277473954 Initial revision
claus
parents:
diff changeset
   145
3f9277473954 Initial revision
claus
parents:
diff changeset
   146
displayOn:aGraphicsContext clippingBox:aRectangle
3f9277473954 Initial revision
claus
parents:
diff changeset
   147
    "display a part of me in aGraphicsContext"
3f9277473954 Initial revision
claus
parents:
diff changeset
   148
3f9277473954 Initial revision
claus
parents:
diff changeset
   149
    ^ self subclassResponsibility
125
fa5b5e4336bf checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   150
! !
0
3f9277473954 Initial revision
claus
parents:
diff changeset
   151