ListEntry.st
author Claus Gittinger <cg@exept.de>
Fri, 16 Oct 2009 11:11:08 +0200
changeset 3764 1414561b990a
parent 2655 4b72f593d5ba
child 5391 4392c1cf3c16
permissions -rw-r--r--
category of: #includes:
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
58
claus
parents:
diff changeset
     1
"
claus
parents:
diff changeset
     2
 COPYRIGHT (c) 1995 by Claus Gittinger
86
4d7dbb5f1719 uff - version methods changed to return stings
Claus Gittinger <cg@exept.de>
parents: 58
diff changeset
     3
	      All Rights Reserved
58
claus
parents:
diff changeset
     4
claus
parents:
diff changeset
     5
 This software is furnished under a license and may be used
claus
parents:
diff changeset
     6
 only in accordance with the terms of that license and with the
claus
parents:
diff changeset
     7
 inclusion of the above copyright notice.   This software may not
claus
parents:
diff changeset
     8
 be provided or otherwise made available to, or used by, any
claus
parents:
diff changeset
     9
 other person.  No title to or ownership of the software is
claus
parents:
diff changeset
    10
 hereby transferred.
claus
parents:
diff changeset
    11
"
1812
c9054636e3ea added #hash
Claus Gittinger <cg@exept.de>
parents: 821
diff changeset
    12
"{ Package: 'stx:libwidg2' }"
c9054636e3ea added #hash
Claus Gittinger <cg@exept.de>
parents: 821
diff changeset
    13
58
claus
parents:
diff changeset
    14
Object subclass:#ListEntry
123
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
    15
	instanceVariableNames:''
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
    16
	classVariableNames:''
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
    17
	poolDictionaries:''
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
    18
	category:'Views-Support'
58
claus
parents:
diff changeset
    19
!
claus
parents:
diff changeset
    20
claus
parents:
diff changeset
    21
!ListEntry class methodsFor:'documentation'!
claus
parents:
diff changeset
    22
claus
parents:
diff changeset
    23
copyright
claus
parents:
diff changeset
    24
"
claus
parents:
diff changeset
    25
 COPYRIGHT (c) 1995 by Claus Gittinger
86
4d7dbb5f1719 uff - version methods changed to return stings
Claus Gittinger <cg@exept.de>
parents: 58
diff changeset
    26
	      All Rights Reserved
58
claus
parents:
diff changeset
    27
claus
parents:
diff changeset
    28
 This software is furnished under a license and may be used
claus
parents:
diff changeset
    29
 only in accordance with the terms of that license and with the
claus
parents:
diff changeset
    30
 inclusion of the above copyright notice.   This software may not
claus
parents:
diff changeset
    31
 be provided or otherwise made available to, or used by, any
claus
parents:
diff changeset
    32
 other person.  No title to or ownership of the software is
claus
parents:
diff changeset
    33
 hereby transferred.
claus
parents:
diff changeset
    34
"
claus
parents:
diff changeset
    35
!
claus
parents:
diff changeset
    36
claus
parents:
diff changeset
    37
documentation
claus
parents:
diff changeset
    38
"
claus
parents:
diff changeset
    39
    ListEntry is an abstract superclass for objects which can be used
claus
parents:
diff changeset
    40
    in place of strings in ListViews or SelectionInListViews.
claus
parents:
diff changeset
    41
claus
parents:
diff changeset
    42
    If you want to create new subclasses, implement (at least) the methods
claus
parents:
diff changeset
    43
    found in the 'required protocol' category.
158
431e38dfc5ab documentation
Claus Gittinger <cg@exept.de>
parents: 123
diff changeset
    44
431e38dfc5ab documentation
Claus Gittinger <cg@exept.de>
parents: 123
diff changeset
    45
    [author:]
431e38dfc5ab documentation
Claus Gittinger <cg@exept.de>
parents: 123
diff changeset
    46
        Claus Gittinger
431e38dfc5ab documentation
Claus Gittinger <cg@exept.de>
parents: 123
diff changeset
    47
431e38dfc5ab documentation
Claus Gittinger <cg@exept.de>
parents: 123
diff changeset
    48
    [see also:]
431e38dfc5ab documentation
Claus Gittinger <cg@exept.de>
parents: 123
diff changeset
    49
        ListView
58
claus
parents:
diff changeset
    50
"
claus
parents:
diff changeset
    51
! !
claus
parents:
diff changeset
    52
669
82c3b58df75e Define #printOn:
Stefan Vogel <sv@exept.de>
parents: 600
diff changeset
    53
!ListEntry methodsFor:'printing & storing'!
82c3b58df75e Define #printOn:
Stefan Vogel <sv@exept.de>
parents: 600
diff changeset
    54
82c3b58df75e Define #printOn:
Stefan Vogel <sv@exept.de>
parents: 600
diff changeset
    55
printOn:aStream
82c3b58df75e Define #printOn:
Stefan Vogel <sv@exept.de>
parents: 600
diff changeset
    56
82c3b58df75e Define #printOn:
Stefan Vogel <sv@exept.de>
parents: 600
diff changeset
    57
    aStream nextPutAll:self asString.
82c3b58df75e Define #printOn:
Stefan Vogel <sv@exept.de>
parents: 600
diff changeset
    58
82c3b58df75e Define #printOn:
Stefan Vogel <sv@exept.de>
parents: 600
diff changeset
    59
    "Created: / 20.1.1998 / 14:11:02 / stefan"
82c3b58df75e Define #printOn:
Stefan Vogel <sv@exept.de>
parents: 600
diff changeset
    60
!
58
claus
parents:
diff changeset
    61
123
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
    62
printString
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
    63
    ^ self asString
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
    64
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
    65
    "Created: 8.2.1996 / 11:56:14 / cg"
669
82c3b58df75e Define #printOn:
Stefan Vogel <sv@exept.de>
parents: 600
diff changeset
    66
! !
82c3b58df75e Define #printOn:
Stefan Vogel <sv@exept.de>
parents: 600
diff changeset
    67
82c3b58df75e Define #printOn:
Stefan Vogel <sv@exept.de>
parents: 600
diff changeset
    68
!ListEntry methodsFor:'queries'!
123
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
    69
2655
4b72f593d5ba hasImage, hasIcon queries added
Claus Gittinger <cg@exept.de>
parents: 2196
diff changeset
    70
hasIcon
4b72f593d5ba hasImage, hasIcon queries added
Claus Gittinger <cg@exept.de>
parents: 2196
diff changeset
    71
    ^ false
4b72f593d5ba hasImage, hasIcon queries added
Claus Gittinger <cg@exept.de>
parents: 2196
diff changeset
    72
!
4b72f593d5ba hasImage, hasIcon queries added
Claus Gittinger <cg@exept.de>
parents: 2196
diff changeset
    73
4b72f593d5ba hasImage, hasIcon queries added
Claus Gittinger <cg@exept.de>
parents: 2196
diff changeset
    74
hasImage
4b72f593d5ba hasImage, hasIcon queries added
Claus Gittinger <cg@exept.de>
parents: 2196
diff changeset
    75
    ^ false
4b72f593d5ba hasImage, hasIcon queries added
Claus Gittinger <cg@exept.de>
parents: 2196
diff changeset
    76
!
4b72f593d5ba hasImage, hasIcon queries added
Claus Gittinger <cg@exept.de>
parents: 2196
diff changeset
    77
3764
1414561b990a category of: #includes:
Claus Gittinger <cg@exept.de>
parents: 2655
diff changeset
    78
includes:aCharacter 
1414561b990a category of: #includes:
Claus Gittinger <cg@exept.de>
parents: 2655
diff changeset
    79
    "behave like a string when testing"
1414561b990a category of: #includes:
Claus Gittinger <cg@exept.de>
parents: 2655
diff changeset
    80
1414561b990a category of: #includes:
Claus Gittinger <cg@exept.de>
parents: 2655
diff changeset
    81
    ^ self string includes:aCharacter
1414561b990a category of: #includes:
Claus Gittinger <cg@exept.de>
parents: 2655
diff changeset
    82
1414561b990a category of: #includes:
Claus Gittinger <cg@exept.de>
parents: 2655
diff changeset
    83
    "Modified: / 30.10.1997 / 15:42:32 / cg"
1414561b990a category of: #includes:
Claus Gittinger <cg@exept.de>
parents: 2655
diff changeset
    84
!
1414561b990a category of: #includes:
Claus Gittinger <cg@exept.de>
parents: 2655
diff changeset
    85
1820
9b17f0c15849 category change
Claus Gittinger <cg@exept.de>
parents: 1812
diff changeset
    86
size
9b17f0c15849 category change
Claus Gittinger <cg@exept.de>
parents: 1812
diff changeset
    87
    "behave like a string when asked for the size"
9b17f0c15849 category change
Claus Gittinger <cg@exept.de>
parents: 1812
diff changeset
    88
9b17f0c15849 category change
Claus Gittinger <cg@exept.de>
parents: 1812
diff changeset
    89
    ^ self string size
9b17f0c15849 category change
Claus Gittinger <cg@exept.de>
parents: 1812
diff changeset
    90
9b17f0c15849 category change
Claus Gittinger <cg@exept.de>
parents: 1812
diff changeset
    91
    "Created: / 8.2.1996 / 12:54:45 / cg"
9b17f0c15849 category change
Claus Gittinger <cg@exept.de>
parents: 1812
diff changeset
    92
    "Modified: / 30.10.1997 / 15:42:19 / cg"
9b17f0c15849 category change
Claus Gittinger <cg@exept.de>
parents: 1812
diff changeset
    93
!
9b17f0c15849 category change
Claus Gittinger <cg@exept.de>
parents: 1812
diff changeset
    94
123
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
    95
species
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
    96
    ^ String
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
    97
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
    98
    "Created: 8.2.1996 / 12:52:38 / cg"
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
    99
!
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   100
58
claus
parents:
diff changeset
   101
string
claus
parents:
diff changeset
   102
    ^ self asString
claus
parents:
diff changeset
   103
! !
claus
parents:
diff changeset
   104
claus
parents:
diff changeset
   105
!ListEntry methodsFor:'required protocol'!
claus
parents:
diff changeset
   106
claus
parents:
diff changeset
   107
asString
claus
parents:
diff changeset
   108
    "return the receiver as a string (for example, to store it in a file)"
claus
parents:
diff changeset
   109
claus
parents:
diff changeset
   110
    ^ self subclassResponsibility
claus
parents:
diff changeset
   111
!
claus
parents:
diff changeset
   112
109
Claus Gittinger <cg@exept.de>
parents: 108
diff changeset
   113
displayOn:aGC x:x y:y opaque:opaque
97
306cb0aa67be checkin from browser
Claus Gittinger <cg@exept.de>
parents: 94
diff changeset
   114
    "display the receiver on a GC"
58
claus
parents:
diff changeset
   115
claus
parents:
diff changeset
   116
    ^ self subclassResponsibility
94
169802ee9a6e *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 86
diff changeset
   117
!
58
claus
parents:
diff changeset
   118
173
d111da00daa9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 158
diff changeset
   119
heightOn:aGC
94
169802ee9a6e *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 86
diff changeset
   120
    "return the height of the receiver when displayed in aGC.
169802ee9a6e *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 86
diff changeset
   121
     Assume the GC's font is taken. If that is not the case in a
169802ee9a6e *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 86
diff changeset
   122
     particular subclass, this method is to be redefined there."
169802ee9a6e *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 86
diff changeset
   123
821
fb1c37408cd9 need device font for query
ca
parents: 734
diff changeset
   124
    ^ aGC font heightOn:(aGC device) 
94
169802ee9a6e *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 86
diff changeset
   125
173
d111da00daa9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 158
diff changeset
   126
    "Created: 12.5.1996 / 20:37:06 / cg"
97
306cb0aa67be checkin from browser
Claus Gittinger <cg@exept.de>
parents: 94
diff changeset
   127
!
306cb0aa67be checkin from browser
Claus Gittinger <cg@exept.de>
parents: 94
diff changeset
   128
2196
2d64b9c3bcea add subclassresponsibility
Stefan Vogel <sv@exept.de>
parents: 1820
diff changeset
   129
sameStringAndEmphasisAs:aStringOrText
2d64b9c3bcea add subclassresponsibility
Stefan Vogel <sv@exept.de>
parents: 1820
diff changeset
   130
2d64b9c3bcea add subclassresponsibility
Stefan Vogel <sv@exept.de>
parents: 1820
diff changeset
   131
    ^ self subclassResponsibility
2d64b9c3bcea add subclassresponsibility
Stefan Vogel <sv@exept.de>
parents: 1820
diff changeset
   132
!
2d64b9c3bcea add subclassresponsibility
Stefan Vogel <sv@exept.de>
parents: 1820
diff changeset
   133
173
d111da00daa9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 158
diff changeset
   134
widthOn:aGC
97
306cb0aa67be checkin from browser
Claus Gittinger <cg@exept.de>
parents: 94
diff changeset
   135
    "return the width (in device units) of the receiver when displayed in aGC"
306cb0aa67be checkin from browser
Claus Gittinger <cg@exept.de>
parents: 94
diff changeset
   136
306cb0aa67be checkin from browser
Claus Gittinger <cg@exept.de>
parents: 94
diff changeset
   137
    ^ self subclassResponsibility
173
d111da00daa9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 158
diff changeset
   138
d111da00daa9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 158
diff changeset
   139
    "Created: 12.5.1996 / 20:53:09 / cg"
58
claus
parents:
diff changeset
   140
! !
claus
parents:
diff changeset
   141
123
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   142
!ListEntry methodsFor:'string protocol'!
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   143
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   144
< aString
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   145
    "behave like a string when comparing"
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   146
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   147
    ^ self asString < aString asString
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   148
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   149
    "Created: 8.2.1996 / 12:01:29 / cg"
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   150
!
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   151
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   152
= aString
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   153
    "behave like a string when comparing"
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   154
734
0fb26bdea415 fixed #=, if species are not alike (i.e. arg is nil)
ca
parents: 669
diff changeset
   155
    self == aString ifTrue:[^ true].
1812
c9054636e3ea added #hash
Claus Gittinger <cg@exept.de>
parents: 821
diff changeset
   156
    ^ self asString = aString asString
123
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   157
!
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   158
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   159
at:index
600
ccedbbd1eac9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 555
diff changeset
   160
    "behave like a string when accessing characters"
ccedbbd1eac9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 555
diff changeset
   161
123
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   162
    ^ self string at:index
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   163
600
ccedbbd1eac9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 555
diff changeset
   164
    "Created: / 8.2.1996 / 12:53:06 / cg"
ccedbbd1eac9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 555
diff changeset
   165
    "Modified: / 30.10.1997 / 15:41:47 / cg"
123
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   166
!
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   167
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   168
do:aBlock
600
ccedbbd1eac9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 555
diff changeset
   169
    "behave like a string when enumerating characters"
ccedbbd1eac9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 555
diff changeset
   170
123
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   171
    ^ self string do:aBlock
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   172
600
ccedbbd1eac9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 555
diff changeset
   173
    "Created: / 8.2.1996 / 12:56:06 / cg"
ccedbbd1eac9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 555
diff changeset
   174
    "Modified: / 30.10.1997 / 15:42:06 / cg"
123
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   175
!
5ac860f2e7b8 more String mimicri protocol
Claus Gittinger <cg@exept.de>
parents: 109
diff changeset
   176
1812
c9054636e3ea added #hash
Claus Gittinger <cg@exept.de>
parents: 821
diff changeset
   177
hash
c9054636e3ea added #hash
Claus Gittinger <cg@exept.de>
parents: 821
diff changeset
   178
    "return an integer useful for hashing"
c9054636e3ea added #hash
Claus Gittinger <cg@exept.de>
parents: 821
diff changeset
   179
c9054636e3ea added #hash
Claus Gittinger <cg@exept.de>
parents: 821
diff changeset
   180
    ^ self asString hash
600
ccedbbd1eac9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 555
diff changeset
   181
! !
ccedbbd1eac9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 555
diff changeset
   182
98
de14b996ee80 version at the end
Claus Gittinger <cg@exept.de>
parents: 97
diff changeset
   183
!ListEntry class methodsFor:'documentation'!
de14b996ee80 version at the end
Claus Gittinger <cg@exept.de>
parents: 97
diff changeset
   184
de14b996ee80 version at the end
Claus Gittinger <cg@exept.de>
parents: 97
diff changeset
   185
version
3764
1414561b990a category of: #includes:
Claus Gittinger <cg@exept.de>
parents: 2655
diff changeset
   186
    ^ '$Header: /cvs/stx/stx/libwidg2/ListEntry.st,v 1.20 2009-10-16 09:11:08 cg Exp $'
1414561b990a category of: #includes:
Claus Gittinger <cg@exept.de>
parents: 2655
diff changeset
   187
!
1414561b990a category of: #includes:
Claus Gittinger <cg@exept.de>
parents: 2655
diff changeset
   188
1414561b990a category of: #includes:
Claus Gittinger <cg@exept.de>
parents: 2655
diff changeset
   189
version_CVS
1414561b990a category of: #includes:
Claus Gittinger <cg@exept.de>
parents: 2655
diff changeset
   190
    ^ '$Header: /cvs/stx/stx/libwidg2/ListEntry.st,v 1.20 2009-10-16 09:11:08 cg Exp $'
98
de14b996ee80 version at the end
Claus Gittinger <cg@exept.de>
parents: 97
diff changeset
   191
! !