PropertyListDictionary.st
author Claus Gittinger <cg@exept.de>
Tue, 09 Sep 2003 11:43:30 +0200
changeset 1810 61452e83a4e1
parent 1803 d69cb54a3b56
child 2090 025a61199960
permissions -rw-r--r--
oops - fromLiteralArrayEncoding was broken
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1803
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
     1
"
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
     2
 COPYRIGHT (c) 1998 by eXept Software AG
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
     3
              All Rights Reserved
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
     4
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
     5
 This software is furnished under a license and may be used
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
     6
 only in accordance with the terms of that license and with the
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
     7
 inclusion of the above copyright notice.   This software may not
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
     8
 be provided or otherwise made available to, or used by, any
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
     9
 other person.  No title to or ownership of the software is
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
    10
 hereby transferred.
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
    11
"
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
    12
1459
748e0d48a148 checkin from browser
ps
parents: 880
diff changeset
    13
"{ Package: 'stx:libview2' }"
748e0d48a148 checkin from browser
ps
parents: 880
diff changeset
    14
880
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    15
IdentityDictionary subclass:#PropertyListDictionary
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    16
	instanceVariableNames:''
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    17
	classVariableNames:''
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    18
	poolDictionaries:''
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    19
	category:'Interface-Support-UI'
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    20
!
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    21
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    22
!PropertyListDictionary class methodsFor:'documentation'!
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    23
1803
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
    24
copyright
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
    25
"
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
    26
 COPYRIGHT (c) 1998 by eXept Software AG
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
    27
              All Rights Reserved
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
    28
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
    29
 This software is furnished under a license and may be used
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
    30
 only in accordance with the terms of that license and with the
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
    31
 inclusion of the above copyright notice.   This software may not
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
    32
 be provided or otherwise made available to, or used by, any
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
    33
 other person.  No title to or ownership of the software is
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
    34
 hereby transferred.
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
    35
"
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
    36
!
d69cb54a3b56 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1730
diff changeset
    37
880
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    38
documentation
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    39
"
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    40
    Instances are used temporarily by the UISpecification to keep dynamic
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    41
    properties for a view.
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    42
    For example, all the callbacks used by the drag & drop operation are
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    43
    stored.
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    44
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    45
    [author:]
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    46
        Claus Atzkern
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    47
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    48
    [see also:]
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    49
        UISpecification
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    50
"
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    51
! !
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    52
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    53
!PropertyListDictionary methodsFor:'accessing'!
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    54
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    55
at:aKey
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    56
    "returns the value stored under the key or nil
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    57
    "
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    58
    ^ self at:aKey ifAbsent:nil
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    59
!
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    60
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    61
dropSourceFor:aReceiver
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    62
    "returns the DropSource for a receiver or nil
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    63
    "
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    64
    |source|
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    65
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    66
    self canDrag ifTrue:[
1730
f6732f77edf8 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 1459
diff changeset
    67
        source := DropSource 
f6732f77edf8 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 1459
diff changeset
    68
                    receiver:aReceiver
f6732f77edf8 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 1459
diff changeset
    69
                    argument:(self at:#dragArgument:)
f6732f77edf8 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 1459
diff changeset
    70
                    dropObjectSelector:(self at:#dropObjectSelector:)
f6732f77edf8 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 1459
diff changeset
    71
                    displayObjectSelector:(self at:#displayObjectSelector:)
f6732f77edf8 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 1459
diff changeset
    72
                    dropFeedBackSelector:(self at:#feedBackSelector:).
880
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    73
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    74
        source startDragSelector:(self at:#startDragSelector:).
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    75
        ^ source
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    76
    ].
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    77
    ^ nil
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    78
!
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    79
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    80
dropTargetFor:aReceiver
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    81
    "returns the DropTarget for a receiver or nil
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    82
    "
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    83
    |target|
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    84
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    85
    self canDrop ifTrue:[
1730
f6732f77edf8 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 1459
diff changeset
    86
        target := DropTarget 
f6732f77edf8 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 1459
diff changeset
    87
                    receiver:aReceiver
f6732f77edf8 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 1459
diff changeset
    88
                    argument:(self at:#dropArgument:)
f6732f77edf8 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 1459
diff changeset
    89
                    dropSelector:(self at:#dropSelector:) 
f6732f77edf8 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 1459
diff changeset
    90
                    canDropSelector:(self at:#canDropSelector:).
880
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    91
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    92
        target enterSelector:(self at:#enterSelector:).
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    93
        target  overSelector:(self at:#overSelector:).
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    94
        target leaveSelector:(self at:#leaveSelector:).
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    95
      ^ target
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    96
    ].
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    97
    ^ nil
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    98
! !
26429c5ffbbe initial checkin
ca
parents:
diff changeset
    99
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   100
!PropertyListDictionary methodsFor:'building'!
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   101
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   102
actionSelectors
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   103
    "returns the list of action selectors 
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   104
    "
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   105
    |list|
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   106
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   107
    list := OrderedCollection new.
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   108
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   109
    self keysAndValuesDo:[:aKey :aVal|
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   110
        (aVal isSymbol and:[self isActionSelector:aKey]) ifTrue:[
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   111
            list add:aVal
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   112
        ]
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   113
    ].
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   114
    ^ list        
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   115
!
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   116
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   117
aspectSelectors
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   118
    "returns the list of aspect selectors or nil 
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   119
    "
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   120
    ^ nil        
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   121
! !
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   122
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   123
!PropertyListDictionary methodsFor:'converting'!
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   124
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   125
fromLiteralArrayEncoding:aLiteralEncodedArray
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   126
    "read my values from an encoding
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   127
    "
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   128
    |key val|
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   129
1810
61452e83a4e1 oops - fromLiteralArrayEncoding was broken
Claus Gittinger <cg@exept.de>
parents: 1803
diff changeset
   130
    2 to:aLiteralEncodedArray size-1 by:2 do:[:i |
880
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   131
        key := aLiteralEncodedArray at:i.
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   132
        val := (aLiteralEncodedArray at:i+1) decodeAsLiteralArray.
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   133
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   134
        self at:key put:val
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   135
    ]
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   136
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   137
!
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   138
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   139
literalArrayEncoding
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   140
    "encode myself as an array, from which a copy of the receiver
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   141
     can be reconstructed with #decodeAsLiteralArray.
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   142
    "
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   143
    |coll|
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   144
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   145
    coll := OrderedCollection new.
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   146
    coll add:(self class name asSymbol).
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   147
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   148
    self keysAndValuesDo:[:aKey :aVal|
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   149
        coll add:aKey; add:(aVal literalArrayEncoding)
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   150
    ].
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   151
    ^ coll asArray
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   152
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   153
! !
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   154
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   155
!PropertyListDictionary methodsFor:'queries'!
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   156
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   157
canDrag
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   158
    "returns true if the receiver of the property list is draggable
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   159
    "
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   160
    ^ self includesKey:#dropObjectSelector:
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   161
!
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   162
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   163
canDrop
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   164
    "returns true if the receiver of the property list is droppable
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   165
    "
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   166
    ^ self includesKey:#dropSelector:
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   167
!
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   168
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   169
isActionSelector:aKey
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   170
    "returns true if the key is an action selector
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   171
    "
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   172
    ^ (     aKey ~~ #dragArgument:
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   173
       and:[aKey ~~ #dropArgument:]
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   174
      )
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   175
! !
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   176
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   177
!PropertyListDictionary class methodsFor:'documentation'!
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   178
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   179
version
1810
61452e83a4e1 oops - fromLiteralArrayEncoding was broken
Claus Gittinger <cg@exept.de>
parents: 1803
diff changeset
   180
    ^ '$Header: /cvs/stx/stx/libview2/PropertyListDictionary.st,v 1.5 2003-09-09 09:43:30 cg Exp $'
880
26429c5ffbbe initial checkin
ca
parents:
diff changeset
   181
! !