AlignmentOrigin.st
author claus
Tue, 29 Aug 1995 19:45:43 +0200
changeset 96 948318b2fbd4
parent 94 8888ddd11323
child 100 0300e64bb883
permissions -rw-r--r--
.
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
"
claus
parents: 83
diff changeset
    12
83
claus
parents:
diff changeset
    13
LayoutOrigin subclass:#AlignmentOrigin
claus
parents:
diff changeset
    14
	 instanceVariableNames:'leftAlignmentFraction topAlignmentFraction'
claus
parents:
diff changeset
    15
	 classVariableNames:''
claus
parents:
diff changeset
    16
	 poolDictionaries:''
claus
parents:
diff changeset
    17
	 category:'Graphics-Geometry'
claus
parents:
diff changeset
    18
!
claus
parents:
diff changeset
    19
88
claus
parents: 83
diff changeset
    20
!AlignmentOrigin class methodsFor:'documentation'!
claus
parents: 83
diff changeset
    21
claus
parents: 83
diff changeset
    22
copyright
claus
parents: 83
diff changeset
    23
"
claus
parents: 83
diff changeset
    24
 COPYRIGHT (c) 1995 by Claus Gittinger
93
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    25
	      All Rights Reserved
88
claus
parents: 83
diff changeset
    26
claus
parents: 83
diff changeset
    27
 This software is furnished under a license and may be used
claus
parents: 83
diff changeset
    28
 only in accordance with the terms of that license and with the
claus
parents: 83
diff changeset
    29
 inclusion of the above copyright notice.   This software may not
claus
parents: 83
diff changeset
    30
 be provided or otherwise made available to, or used by, any
claus
parents: 83
diff changeset
    31
 other person.  No title to or ownership of the software is
claus
parents: 83
diff changeset
    32
 hereby transferred.
claus
parents: 83
diff changeset
    33
"
claus
parents: 83
diff changeset
    34
!
claus
parents: 83
diff changeset
    35
93
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    36
documentation
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    37
"
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    38
    This class is provided to make porting of existing ST-80 applications
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    39
    easier. Instances can be used to control the geometry of a subview, within
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    40
    its superview. Like a LayoutOrigin, it controls the components origin
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    41
    via a relative part plus offset. However, in contrast to LayoutOrigin
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    42
    (in which the top-left corner is specified by fraction+offset, here any
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    43
    reference point within the component is positioned.
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    44
    The reference point itself is specified as fraction of the components size.
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    45
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    46
    See also:
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    47
	LayoutOrigin LayoutFrame Layout
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    48
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    49
    Notice: this class was implemented using protocol information
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    50
    from alpha testers - it may not be complete or compatible to
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    51
    the corresponding ST-80 class. If you encounter any incompatibilities,
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    52
    please forward a note to the ST/X team.
94
8888ddd11323 *** empty log message ***
claus
parents: 93
diff changeset
    53
"
93
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    54
!
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    55
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    56
examples
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    57
"
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    58
    using a LayoutOrigin, to control the top-left origins position of
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    59
    a component (i.e. origin at:0.5@0.5):
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    60
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    61
	|top button|
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    62
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    63
	top := StandardSystemView new.
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    64
	top extent:300@300.
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    65
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    66
	button := Button label:'component'.
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    67
	top add:button in:(LayoutOrigin new
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    68
				leftFraction:0.5;
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    69
				topFraction:0.5).
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    70
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    71
	top open
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    72
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    73
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    74
    using an AlignmentOrigin, to control the centers position of
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    75
    a component (i.e. center of component at:0.5@0.5):
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    76
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    77
	|top button|
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    78
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    79
	top := StandardSystemView new.
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    80
	top extent:300@300.
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    81
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    82
	button := Button label:'component'.
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    83
	top add:button in:(AlignmentOrigin new
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    84
				leftFraction:0.5;
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    85
				topFraction:0.5;
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    86
				leftAlignmentFraction:0.5;
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    87
				topAlignmentFraction:0.5).
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    88
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    89
	top open
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    90
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    91
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    92
    using an AlignmentOrigin, to control the bottom-right position of
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    93
    a component (i.e. bottom-right of component at:0.5@0.5):
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    94
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    95
	|top button|
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    96
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    97
	top := StandardSystemView new.
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    98
	top extent:300@300.
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
    99
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
   100
	button := Button label:'component'.
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
   101
	top add:button in:(AlignmentOrigin new
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
   102
				leftFraction:0.5;
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
   103
				topFraction:0.5;
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
   104
				leftAlignmentFraction:1.0;
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
   105
				topAlignmentFraction:1.0).
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
   106
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
   107
	top open
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
   108
"
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
   109
!
f2389560b8eb *** empty log message ***
claus
parents: 88
diff changeset
   110
88
claus
parents: 83
diff changeset
   111
version
claus
parents: 83
diff changeset
   112
"
96
claus
parents: 94
diff changeset
   113
$Header: /cvs/stx/stx/libview2/AlignmentOrigin.st,v 1.5 1995-08-29 17:42:57 claus Exp $
88
claus
parents: 83
diff changeset
   114
"
claus
parents: 83
diff changeset
   115
! !
claus
parents: 83
diff changeset
   116
83
claus
parents:
diff changeset
   117
!AlignmentOrigin methodsFor:'accessing'!
claus
parents:
diff changeset
   118
claus
parents:
diff changeset
   119
leftAlignmentFraction:something
claus
parents:
diff changeset
   120
    "set leftAlignmentFraction"
claus
parents:
diff changeset
   121
claus
parents:
diff changeset
   122
    leftAlignmentFraction := something.
claus
parents:
diff changeset
   123
!
claus
parents:
diff changeset
   124
claus
parents:
diff changeset
   125
leftAlignmentFraction
claus
parents:
diff changeset
   126
    "return leftAlignmentFraction"
claus
parents:
diff changeset
   127
claus
parents:
diff changeset
   128
    ^ leftAlignmentFraction
claus
parents:
diff changeset
   129
!
claus
parents:
diff changeset
   130
claus
parents:
diff changeset
   131
topAlignmentFraction:something
claus
parents:
diff changeset
   132
    "set topAlignmentFraction"
claus
parents:
diff changeset
   133
claus
parents:
diff changeset
   134
    topAlignmentFraction := something.
claus
parents:
diff changeset
   135
!
claus
parents:
diff changeset
   136
claus
parents:
diff changeset
   137
topAlignmentFraction
claus
parents:
diff changeset
   138
    "return topAlignmentFraction"
claus
parents:
diff changeset
   139
claus
parents:
diff changeset
   140
    ^ topFraction
claus
parents:
diff changeset
   141
! !
claus
parents:
diff changeset
   142
claus
parents:
diff changeset
   143
!AlignmentOrigin methodsFor:'printing & storing'!
claus
parents:
diff changeset
   144
claus
parents:
diff changeset
   145
displayString
claus
parents:
diff changeset
   146
    ^ 'LayoutOrigin(' 
claus
parents:
diff changeset
   147
	, 'l: ' , leftFraction displayString
claus
parents:
diff changeset
   148
	, '+' , leftOffset displayString
claus
parents:
diff changeset
   149
	, ' t: ' , topFraction displayString
claus
parents:
diff changeset
   150
	, '+' , topOffset displayString
claus
parents:
diff changeset
   151
	, ' a: ' , leftAlignmentFraction displayString
claus
parents:
diff changeset
   152
	, '@' , topAlignmentFraction displayString
claus
parents:
diff changeset
   153
	, ')'
claus
parents:
diff changeset
   154
! !
claus
parents:
diff changeset
   155
claus
parents:
diff changeset
   156
claus
parents:
diff changeset
   157
!AlignmentOrigin methodsFor:'queries'!
claus
parents:
diff changeset
   158
claus
parents:
diff changeset
   159
rectangleRelativeTo:superRectangle preferred:prefRect
claus
parents:
diff changeset
   160
    |x y|
claus
parents:
diff changeset
   161
claus
parents:
diff changeset
   162
    leftOffset isNil ifTrue:[
claus
parents:
diff changeset
   163
	x := 0
claus
parents:
diff changeset
   164
    ] ifFalse:[
claus
parents:
diff changeset
   165
	x := leftOffset
claus
parents:
diff changeset
   166
    ].
claus
parents:
diff changeset
   167
    topOffset isNil ifTrue:[
claus
parents:
diff changeset
   168
	y := 0
claus
parents:
diff changeset
   169
    ] ifFalse:[
claus
parents:
diff changeset
   170
	y := topOffset
claus
parents:
diff changeset
   171
    ].
claus
parents:
diff changeset
   172
    leftFraction notNil ifTrue:[
claus
parents:
diff changeset
   173
	x := x + (superRectangle width * leftFraction)
claus
parents:
diff changeset
   174
    ].
claus
parents:
diff changeset
   175
    topFraction notNil ifTrue:[
claus
parents:
diff changeset
   176
	y := y + (superRectangle height * topFraction)
claus
parents:
diff changeset
   177
    ].
claus
parents:
diff changeset
   178
    leftAlignmentFraction ~~ 0 ifTrue:[
claus
parents:
diff changeset
   179
	x := x - (prefRect width * leftAlignmentFraction)
claus
parents:
diff changeset
   180
    ].
claus
parents:
diff changeset
   181
    topAlignmentFraction ~~ 0 ifTrue:[
claus
parents:
diff changeset
   182
	y := y - (prefRect height * topAlignmentFraction)
claus
parents:
diff changeset
   183
    ].
claus
parents:
diff changeset
   184
    ^ Rectangle origin:x@y extent:prefRect extent
claus
parents:
diff changeset
   185
claus
parents:
diff changeset
   186
    "
claus
parents:
diff changeset
   187
     |superRect aO|
claus
parents:
diff changeset
   188
claus
parents:
diff changeset
   189
     superRect := 0@0 corner:100@100.
claus
parents:
diff changeset
   190
     aO := (AlignmentOrigin new).
claus
parents:
diff changeset
   191
     aO leftFraction:0.5;
claus
parents:
diff changeset
   192
	topFraction:0.5;
claus
parents:
diff changeset
   193
	leftAlignmentFraction:0.5;
claus
parents:
diff changeset
   194
	topAlignmentFraction:0.5.
claus
parents:
diff changeset
   195
     aO rectangleRelativeTo:superRect preferred:(0@0 corner:30@30) 
claus
parents:
diff changeset
   196
    "
claus
parents:
diff changeset
   197
! !
claus
parents:
diff changeset
   198
claus
parents:
diff changeset
   199
!AlignmentOrigin methodsFor:'initialization'!
claus
parents:
diff changeset
   200
claus
parents:
diff changeset
   201
initialize
claus
parents:
diff changeset
   202
    super initialize.
claus
parents:
diff changeset
   203
    leftAlignmentFraction := topAlignmentFraction := 0.
claus
parents:
diff changeset
   204
! !