Class: Model

• Inheritance
• Description
• Related information
• Instance protocol
  • converting
  • copying
  • dependents access
  • dependents access (non weak)

Inheritance:

   Object
   |
   +--Model
      |
      +--ApplicationModel
      |
      +--GraphColumn
      |
      +--HTTPServerSettingsAppl::PluggableServicesSettingsAppl::AvailableServiceItem
      |
      +--Plug
      |
      +--SelectionInHierarchy
      |
      +--SelectionInTree
      |
      +--TabItem
      |
      +--TabulatorSpecification
      |
      +--ValueModel

Package:

stx:libview2

Category:

Interface-Support-Models

Version:

rev: 1.39 date: 2009/05/14 19:58:40

user: cg

file: Model.st directory: libview2

module: stx stc-classLibrary: libview2

Author:

Claus Gittinger

Description:

Models are things which represent information models, i.e. something
which holds the data for user interface components and on which these operate.
Basically, instances keep track of which components depend on them and 
inform the dependents of any changes.

The Model class itself is abstract and not too useful, see subclasses,
especially, ValueHolder and SelectionInList.

Notice:
  Actually the Model class is not really needed; since the dependency
  mechanism is inherited by Object, you can take any object as a model.
  However, instances of Model (and subclasses) keep the dependents locally
  in an instance variable; thus speeding up access a bit.

[Instance variables:]
    dependents      <Collection>    those objects which depend on me.
                                    To save some storage, a single dependent 
                                    is kept directly here.
                                    Otherwise, if there are multiple dependents,
                                    a collection of dependents is held here.

Related information:

    ValueHolder
    SelectionInList
    [introduction to view programming]

Instance protocol:

 skippedInLiteralEncoding

return a Collection with elements which are skipped in the encoding

 postCopy

release dependents after copying

 postDeepCopy

release dependents after copying

 skipInstvarIndexInDeepCopy: index

a helper for deepCopy; only indices for which this method returns
false are copied in a deep copy.

 addDependent: anObject

make the argument, anObject be a dependent of the receiver

 dependents

return a Collection of dependents

 dependents: aCollection

set the collection of dependents

 dependentsDo: aBlock

evaluate aBlock for all of my dependents

 release

remove all dependencies from the receiver

 removeDependent: anObject

make the argument, anObject be independent of the receiver

 addNonWeakDependent: anObject

make the argument, anObject be a dependent of the receiver.
Since all dependencies are nonWeak in Model, this is simply
forwarded to addDependent:

 interests

return a Collection of interests - empty if there is none.
Here, we use the normal dependents collection for interests.

 nonWeakDependents

return a Collection of dependents - empty if there is none.
Since all dependencies are nonWeak in Model, this is a dummy.

 removeNonWeakDependent: anObject

make the argument, anObject be independent of the receiver.
Since all dependencies are nonWeak in Model, this is simply
forwarded to removeDependent: