Model.st
author Claus Gittinger <cg@exept.de>
Sun, 29 Oct 1995 20:36:22 +0100
changeset 109 9e1383121df4
parent 99 a656b0c9dd21
child 114 e577a2f332d0
permissions -rw-r--r--
*** empty log message ***
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
3f9277473954 Initial revision
claus
parents:
diff changeset
    14
       instanceVariableNames:'dependents'
3f9277473954 Initial revision
claus
parents:
diff changeset
    15
       classVariableNames:''
3f9277473954 Initial revision
claus
parents:
diff changeset
    16
       poolDictionaries:''
71
claus
parents: 48
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
version
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    37
"
99
claus
parents: 96
diff changeset
    38
$Header: /cvs/stx/stx/libview2/Model.st,v 1.14 1995-08-30 17:54:04 claus Exp $
21
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    39
"
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    40
!
0
3f9277473954 Initial revision
claus
parents:
diff changeset
    41
21
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    42
documentation
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    43
"
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    44
    Models are things that are presented in views. Instances keep track of 
35
f13cdd0b44c7 *** empty log message ***
claus
parents: 28
diff changeset
    45
    which views are dependent of them and inform them of any changes.
87
claus
parents: 83
diff changeset
    46
    Actually the Model class is not really needed; since the dependency
claus
parents: 83
diff changeset
    47
    mechanism is inherited by Object, you can take any object as a model.
claus
parents: 83
diff changeset
    48
    However, instances of Model (and subclasses) keep the dependents locally
35
f13cdd0b44c7 *** empty log message ***
claus
parents: 28
diff changeset
    49
    in an instance variable; thus speeding up access a bit.
f13cdd0b44c7 *** empty log message ***
claus
parents: 28
diff changeset
    50
21
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    51
    Instance variables:
87
claus
parents: 83
diff changeset
    52
	dependents      Collection      those objects which depend on me.
claus
parents: 83
diff changeset
    53
					To save some storage, the dependent is
claus
parents: 83
diff changeset
    54
					kept directly here, IFF there os only one.
claus
parents: 83
diff changeset
    55
					Otherwise, a collection of dependents is
claus
parents: 83
diff changeset
    56
					held here.
21
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    57
"
66b31c91177f *** empty log message ***
claus
parents: 10
diff changeset
    58
! !
0
3f9277473954 Initial revision
claus
parents:
diff changeset
    59
83
claus
parents: 71
diff changeset
    60
!Model methodsFor:'dependents access'!
0
3f9277473954 Initial revision
claus
parents:
diff changeset
    61
3f9277473954 Initial revision
claus
parents:
diff changeset
    62
dependents
3f9277473954 Initial revision
claus
parents:
diff changeset
    63
    "return a Collection of dependents - nil if there is none"
3f9277473954 Initial revision
claus
parents:
diff changeset
    64
3f9277473954 Initial revision
claus
parents:
diff changeset
    65
    ^ dependents
3f9277473954 Initial revision
claus
parents:
diff changeset
    66
!
3f9277473954 Initial revision
claus
parents:
diff changeset
    67
10
6693d06dd076 *** empty log message ***
claus
parents: 6
diff changeset
    68
dependents:aCollection
6693d06dd076 *** empty log message ***
claus
parents: 6
diff changeset
    69
    "set the collection of dependents"
0
3f9277473954 Initial revision
claus
parents:
diff changeset
    70
10
6693d06dd076 *** empty log message ***
claus
parents: 6
diff changeset
    71
    dependents := aCollection
83
claus
parents: 71
diff changeset
    72
!
claus
parents: 71
diff changeset
    73
claus
parents: 71
diff changeset
    74
release
claus
parents: 71
diff changeset
    75
    dependents := nil
claus
parents: 71
diff changeset
    76
!
claus
parents: 71
diff changeset
    77
claus
parents: 71
diff changeset
    78
addDependent:anObject
claus
parents: 71
diff changeset
    79
    "make the argument, anObject be a dependent of the receiver"
claus
parents: 71
diff changeset
    80
claus
parents: 71
diff changeset
    81
    |deps|
claus
parents: 71
diff changeset
    82
claus
parents: 71
diff changeset
    83
    deps := dependents.
claus
parents: 71
diff changeset
    84
    deps isNil ifTrue:[
claus
parents: 71
diff changeset
    85
	dependents := anObject
claus
parents: 71
diff changeset
    86
    ] ifFalse:[
claus
parents: 71
diff changeset
    87
	(deps isMemberOf:IdentitySet) ifTrue:[
claus
parents: 71
diff changeset
    88
	    deps add:anObject
claus
parents: 71
diff changeset
    89
	] ifFalse:[
claus
parents: 71
diff changeset
    90
	    dependents := IdentitySet with:dependents with:anObject
claus
parents: 71
diff changeset
    91
	]
claus
parents: 71
diff changeset
    92
    ]
claus
parents: 71
diff changeset
    93
!
claus
parents: 71
diff changeset
    94
claus
parents: 71
diff changeset
    95
dependentsDo:aBlock
claus
parents: 71
diff changeset
    96
    "evaluate aBlock for all of my dependents"
claus
parents: 71
diff changeset
    97
claus
parents: 71
diff changeset
    98
    |deps|
claus
parents: 71
diff changeset
    99
claus
parents: 71
diff changeset
   100
    deps := dependents.
claus
parents: 71
diff changeset
   101
    deps notNil ifTrue:[
claus
parents: 71
diff changeset
   102
	(deps isMemberOf:IdentitySet) ifTrue:[
claus
parents: 71
diff changeset
   103
	    deps do:aBlock
claus
parents: 71
diff changeset
   104
	] ifFalse:[
claus
parents: 71
diff changeset
   105
	    aBlock value:deps
claus
parents: 71
diff changeset
   106
	]
claus
parents: 71
diff changeset
   107
    ]
claus
parents: 71
diff changeset
   108
!
claus
parents: 71
diff changeset
   109
claus
parents: 71
diff changeset
   110
removeDependent:anObject
claus
parents: 71
diff changeset
   111
    "make the argument, anObject be independent of the receiver"
claus
parents: 71
diff changeset
   112
claus
parents: 71
diff changeset
   113
    |deps sz|
claus
parents: 71
diff changeset
   114
claus
parents: 71
diff changeset
   115
    deps := dependents.
claus
parents: 71
diff changeset
   116
    deps notNil ifTrue:[
claus
parents: 71
diff changeset
   117
	(deps isMemberOf:IdentitySet) ifTrue:[
claus
parents: 71
diff changeset
   118
	    deps remove:anObject ifAbsent:[].
claus
parents: 71
diff changeset
   119
	    (sz := deps size) == 1 ifTrue:[
claus
parents: 71
diff changeset
   120
		dependents := deps first
claus
parents: 71
diff changeset
   121
	    ] ifFalse:[
claus
parents: 71
diff changeset
   122
		(sz == 0) ifTrue:[
claus
parents: 71
diff changeset
   123
		    dependents := nil
claus
parents: 71
diff changeset
   124
		]
claus
parents: 71
diff changeset
   125
	    ]
claus
parents: 71
diff changeset
   126
	] ifFalse:[
claus
parents: 71
diff changeset
   127
	    dependents := nil
claus
parents: 71
diff changeset
   128
	]
claus
parents: 71
diff changeset
   129
    ]
0
3f9277473954 Initial revision
claus
parents:
diff changeset
   130
! !
3f9277473954 Initial revision
claus
parents:
diff changeset
   131
28
8daff0234d2e *** empty log message ***
claus
parents: 23
diff changeset
   132
!Model methodsFor:'copying'!
8daff0234d2e *** empty log message ***
claus
parents: 23
diff changeset
   133
8daff0234d2e *** empty log message ***
claus
parents: 23
diff changeset
   134
postCopy
8daff0234d2e *** empty log message ***
claus
parents: 23
diff changeset
   135
    "release dependents after copying"
8daff0234d2e *** empty log message ***
claus
parents: 23
diff changeset
   136
8daff0234d2e *** empty log message ***
claus
parents: 23
diff changeset
   137
    self dependents:nil
8daff0234d2e *** empty log message ***
claus
parents: 23
diff changeset
   138
! !
8daff0234d2e *** empty log message ***
claus
parents: 23
diff changeset
   139
0
3f9277473954 Initial revision
claus
parents:
diff changeset
   140
!Model methodsFor:'drawing'!
3f9277473954 Initial revision
claus
parents:
diff changeset
   141
3f9277473954 Initial revision
claus
parents:
diff changeset
   142
displayOn:aGraphicsContext clippingBox:aRectangle
3f9277473954 Initial revision
claus
parents:
diff changeset
   143
    "display a part of me in aGraphicsContext"
3f9277473954 Initial revision
claus
parents:
diff changeset
   144
3f9277473954 Initial revision
claus
parents:
diff changeset
   145
    ^ self subclassResponsibility
3f9277473954 Initial revision
claus
parents:
diff changeset
   146
!
3f9277473954 Initial revision
claus
parents:
diff changeset
   147
3f9277473954 Initial revision
claus
parents:
diff changeset
   148
displayOn:aGraphicsContext
3f9277473954 Initial revision
claus
parents:
diff changeset
   149
    "display myself in aGraphicsContext"
3f9277473954 Initial revision
claus
parents:
diff changeset
   150
3f9277473954 Initial revision
claus
parents:
diff changeset
   151
    ^ self subclassResponsibility
3f9277473954 Initial revision
claus
parents:
diff changeset
   152
! !