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