Layout.st
author Claus Gittinger <cg@exept.de>
Tue, 27 Mar 2007 11:20:25 +0200
changeset 2294 0bae42618306
parent 2137 1cc62200836d
child 3616 b79beb6fb8cf
permissions -rw-r--r--
no need to redefine decodeAsLiteralArray
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
88
claus
parents: 83
diff changeset
     1
"
claus
parents: 83
diff changeset
     2
 COPYRIGHT (c) 1995 by Claus Gittinger
93
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
     3
	      All Rights Reserved
88
claus
parents: 83
diff changeset
     4
claus
parents: 83
diff changeset
     5
 This software is furnished under a license and may be used
claus
parents: 83
diff changeset
     6
 only in accordance with the terms of that license and with the
claus
parents: 83
diff changeset
     7
 inclusion of the above copyright notice.   This software may not
claus
parents: 83
diff changeset
     8
 be provided or otherwise made available to, or used by, any
claus
parents: 83
diff changeset
     9
 other person.  No title to or ownership of the software is
claus
parents: 83
diff changeset
    10
 hereby transferred.
claus
parents: 83
diff changeset
    11
"
2137
1cc62200836d Fix comments.
Stefan Vogel <sv@exept.de>
parents: 949
diff changeset
    12
"{ Package: 'stx:libview2' }"
1cc62200836d Fix comments.
Stefan Vogel <sv@exept.de>
parents: 949
diff changeset
    13
77
claus
parents:
diff changeset
    14
Object subclass:#Layout
216
a5f97668e99a commentary
Claus Gittinger <cg@exept.de>
parents: 126
diff changeset
    15
	instanceVariableNames:''
a5f97668e99a commentary
Claus Gittinger <cg@exept.de>
parents: 126
diff changeset
    16
	classVariableNames:''
a5f97668e99a commentary
Claus Gittinger <cg@exept.de>
parents: 126
diff changeset
    17
	poolDictionaries:''
a5f97668e99a commentary
Claus Gittinger <cg@exept.de>
parents: 126
diff changeset
    18
	category:'Graphics-Geometry'
77
claus
parents:
diff changeset
    19
!
claus
parents:
diff changeset
    20
88
claus
parents: 83
diff changeset
    21
!Layout class methodsFor:'documentation'!
claus
parents: 83
diff changeset
    22
claus
parents: 83
diff changeset
    23
copyright
claus
parents: 83
diff changeset
    24
"
claus
parents: 83
diff changeset
    25
 COPYRIGHT (c) 1995 by Claus Gittinger
93
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    26
	      All Rights Reserved
88
claus
parents: 83
diff changeset
    27
claus
parents: 83
diff changeset
    28
 This software is furnished under a license and may be used
claus
parents: 83
diff changeset
    29
 only in accordance with the terms of that license and with the
claus
parents: 83
diff changeset
    30
 inclusion of the above copyright notice.   This software may not
claus
parents: 83
diff changeset
    31
 be provided or otherwise made available to, or used by, any
claus
parents: 83
diff changeset
    32
 other person.  No title to or ownership of the software is
claus
parents: 83
diff changeset
    33
 hereby transferred.
claus
parents: 83
diff changeset
    34
"
claus
parents: 83
diff changeset
    35
!
claus
parents: 83
diff changeset
    36
93
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    37
documentation
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    38
"
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    39
    This is an abstract superclass for geometry controlling objects.
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    40
    While old smalltalks used relative origin/extent/corner and absolute
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    41
    origin/corner/extents, these mechanisms are now being removed from the
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    42
    view itself into geometry controlling objects, which are given a superviews
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    43
    size and are to return a components size upon request.
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    44
    This allows more flexible geometry management, since any algorithm can
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    45
    be implemented (if the existing ones are not sufficient, add you own subclass
96
claus
parents: 94
diff changeset
    46
    and install it as layout-object in your view).
93
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    47
229
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    48
    Notice: 
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    49
        this class was implemented using protocol information
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    50
        from alpha testers - it may not be complete or compatible to
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    51
        the corresponding ST-80 class. 
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    52
        If you encounter any incompatibilities, please forward a note 
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    53
        describing the incompatibility verbal (i.e. no code) to the ST/X team.
219
106b86ca81da documentation
Claus Gittinger <cg@exept.de>
parents: 216
diff changeset
    54
106b86ca81da documentation
Claus Gittinger <cg@exept.de>
parents: 216
diff changeset
    55
    [author:]
106b86ca81da documentation
Claus Gittinger <cg@exept.de>
parents: 216
diff changeset
    56
        Claus Gittinger
229
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    57
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    58
    [see also:]
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    59
        View
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    60
        LayoutOrigin LayoutFrame AlignmentOrigin
94
8888ddd11323 *** empty log message ***
claus
parents: 93
diff changeset
    61
"
88
claus
parents: 83
diff changeset
    62
! !
claus
parents: 83
diff changeset
    63
77
claus
parents:
diff changeset
    64
!Layout class methodsFor:'instance creation'!
claus
parents:
diff changeset
    65
claus
parents:
diff changeset
    66
new
229
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    67
    "return a new initialized instance"
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    68
77
claus
parents:
diff changeset
    69
    ^ self basicNew initialize
229
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    70
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    71
    "Modified: 27.4.1996 / 14:47:08 / cg"
77
claus
parents:
diff changeset
    72
! !
claus
parents:
diff changeset
    73
284
b31698e4ebb6 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 229
diff changeset
    74
!Layout methodsFor:'converting'!
b31698e4ebb6 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 229
diff changeset
    75
b31698e4ebb6 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 229
diff changeset
    76
asLayout
b31698e4ebb6 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 229
diff changeset
    77
    "return the receiver"
b31698e4ebb6 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 229
diff changeset
    78
b31698e4ebb6 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 229
diff changeset
    79
    ^ self
b31698e4ebb6 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 229
diff changeset
    80
b31698e4ebb6 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 229
diff changeset
    81
    "Created: 29.5.1996 / 15:12:13 / cg"
b31698e4ebb6 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 229
diff changeset
    82
! !
b31698e4ebb6 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 229
diff changeset
    83
77
claus
parents:
diff changeset
    84
!Layout methodsFor:'initialization'!
claus
parents:
diff changeset
    85
claus
parents:
diff changeset
    86
initialize
229
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    87
    "setup the instance - to be redefined by concrete subclasses"
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    88
77
claus
parents:
diff changeset
    89
    ^ self subclassResponsibility
229
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    90
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    91
    "Modified: 27.4.1996 / 14:46:56 / cg"
77
claus
parents:
diff changeset
    92
! !
126
25df58661f32 version at the end
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    93
25df58661f32 version at the end
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    94
!Layout methodsFor:'queries'!
25df58661f32 version at the end
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    95
415
5d1bf4dffbf5 *** empty log message ***
ca
parents: 284
diff changeset
    96
isAlignmentOrigin
5d1bf4dffbf5 *** empty log message ***
ca
parents: 284
diff changeset
    97
    "return true, if this is an alignmentOrigin"
5d1bf4dffbf5 *** empty log message ***
ca
parents: 284
diff changeset
    98
5d1bf4dffbf5 *** empty log message ***
ca
parents: 284
diff changeset
    99
    ^ false
5d1bf4dffbf5 *** empty log message ***
ca
parents: 284
diff changeset
   100
5d1bf4dffbf5 *** empty log message ***
ca
parents: 284
diff changeset
   101
!
5d1bf4dffbf5 *** empty log message ***
ca
parents: 284
diff changeset
   102
126
25df58661f32 version at the end
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   103
isLayout
229
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
   104
    "return true, if the recevier is a layout object. 
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
   105
     Always return true here."
415
5d1bf4dffbf5 *** empty log message ***
ca
parents: 284
diff changeset
   106
126
25df58661f32 version at the end
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   107
    ^ true
229
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
   108
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
   109
    "Modified: 27.4.1996 / 14:45:27 / cg"
126
25df58661f32 version at the end
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   110
!
25df58661f32 version at the end
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   111
417
3b5a3b678ede *** empty log message ***
ca
parents: 415
diff changeset
   112
isLayoutFrame
3b5a3b678ede *** empty log message ***
ca
parents: 415
diff changeset
   113
    "return true, if this is a layoutFrame"
3b5a3b678ede *** empty log message ***
ca
parents: 415
diff changeset
   114
3b5a3b678ede *** empty log message ***
ca
parents: 415
diff changeset
   115
    ^ false
3b5a3b678ede *** empty log message ***
ca
parents: 415
diff changeset
   116
3b5a3b678ede *** empty log message ***
ca
parents: 415
diff changeset
   117
!
3b5a3b678ede *** empty log message ***
ca
parents: 415
diff changeset
   118
415
5d1bf4dffbf5 *** empty log message ***
ca
parents: 284
diff changeset
   119
isLayoutOrigin
5d1bf4dffbf5 *** empty log message ***
ca
parents: 284
diff changeset
   120
    "return true, if this is a layoutOrigin"
5d1bf4dffbf5 *** empty log message ***
ca
parents: 284
diff changeset
   121
5d1bf4dffbf5 *** empty log message ***
ca
parents: 284
diff changeset
   122
    ^ false
5d1bf4dffbf5 *** empty log message ***
ca
parents: 284
diff changeset
   123
5d1bf4dffbf5 *** empty log message ***
ca
parents: 284
diff changeset
   124
!
5d1bf4dffbf5 *** empty log message ***
ca
parents: 284
diff changeset
   125
949
0eb888b21192 prefRect may now be a valueHolder or block
Claus Gittinger <cg@exept.de>
parents: 785
diff changeset
   126
rectangleRelativeTo:superRectangle preferred:prefRectHolder
229
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
   127
    "compute the rectangle represented by the receiver,
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
   128
     given the superViews rectangle and the views preferredExtent.
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
   129
     Must be implemented by concrete subclasses."
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
   130
126
25df58661f32 version at the end
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   131
    ^ self subclassResponsibility
229
612861ef768a examples
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
   132
949
0eb888b21192 prefRect may now be a valueHolder or block
Claus Gittinger <cg@exept.de>
parents: 785
diff changeset
   133
    "Modified: / 27.5.1998 / 10:19:21 / cg"
126
25df58661f32 version at the end
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   134
! !
25df58661f32 version at the end
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   135
25df58661f32 version at the end
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   136
!Layout class methodsFor:'documentation'!
25df58661f32 version at the end
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   137
25df58661f32 version at the end
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   138
version
2294
0bae42618306 no need to redefine decodeAsLiteralArray
Claus Gittinger <cg@exept.de>
parents: 2137
diff changeset
   139
    ^ '$Header: /cvs/stx/stx/libview2/Layout.st,v 1.18 2007-03-27 09:20:25 cg Exp $'
126
25df58661f32 version at the end
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   140
! !