EnterFieldGroup.st
author claus
Sun, 07 May 1995 02:16:56 +0200
changeset 122 04ec3fda7c11
parent 121 4e63bbdb266a
child 125 3ffa271732f7
permissions -rw-r--r--
.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
     1
"
5
claus
parents: 3
diff changeset
     2
 COPYRIGHT (c) 1992 by Claus Gittinger
69
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
     3
	      All Rights Reserved
0
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
     4
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
     5
 This software is furnished under a license and may be used
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
     6
 only in accordance with the terms of that license and with the
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
     7
 inclusion of the above copyright notice.   This software may not
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
     8
 be provided or otherwise made available to, or used by, any
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
     9
 other person.  No title to or ownership of the software is
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
    10
 hereby transferred.
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
    11
"
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
    12
7
15a9291b9bd0 *** empty log message ***
claus
parents: 5
diff changeset
    13
Object subclass:#EnterFieldGroup
122
claus
parents: 121
diff changeset
    14
	 instanceVariableNames:'fields currentField leaveAction
claus
parents: 121
diff changeset
    15
				wrap'
69
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
    16
	 classVariableNames:''
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
    17
	 poolDictionaries:''
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
    18
	 category:'Views-Support'
0
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
    19
!
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
    20
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
    21
EnterFieldGroup comment:'
5
claus
parents: 3
diff changeset
    22
COPYRIGHT (c) 1992 by Claus Gittinger
69
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
    23
	      All Rights Reserved
0
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
    24
122
claus
parents: 121
diff changeset
    25
$Header: /cvs/stx/stx/libwidg/EnterFieldGroup.st,v 1.9 1995-05-07 00:15:50 claus Exp $
38
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    26
'!
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    27
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    28
!EnterFieldGroup class methodsFor:'documentation'!
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    29
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    30
copyright
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    31
"
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    32
 COPYRIGHT (c) 1992 by Claus Gittinger
69
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
    33
	      All Rights Reserved
0
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
    34
38
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    35
 This software is furnished under a license and may be used
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    36
 only in accordance with the terms of that license and with the
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    37
 inclusion of the above copyright notice.   This software may not
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    38
 be provided or otherwise made available to, or used by, any
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    39
 other person.  No title to or ownership of the software is
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    40
 hereby transferred.
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    41
"
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    42
!
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    43
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    44
version
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    45
"
122
claus
parents: 121
diff changeset
    46
$Header: /cvs/stx/stx/libwidg/EnterFieldGroup.st,v 1.9 1995-05-07 00:15:50 claus Exp $
38
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    47
"
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    48
!
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    49
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    50
documentation
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    51
"
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    52
    EnterFieldGroup controlls the interaction between EnterFields
121
claus
parents: 69
diff changeset
    53
    enabling next/prev field when a field is left. 
claus
parents: 69
diff changeset
    54
    Instances of this class keep track of which field of the group is the 
claus
parents: 69
diff changeset
    55
    currentField (i.e. the one getting keyboard input) and forwards input
claus
parents: 69
diff changeset
    56
    to the active field (having the inputField delegate its input to me).
claus
parents: 69
diff changeset
    57
38
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
    58
    The block accessable as leaveAction is evaluated when the last
121
claus
parents: 69
diff changeset
    59
    field of the group is left (by cursor-down or cr). 
claus
parents: 69
diff changeset
    60
    Usually this block triggers accept on the fields and/or performs some
claus
parents: 69
diff changeset
    61
    followup processing and closes  the topview (for example: in a dialog).
122
claus
parents: 121
diff changeset
    62
claus
parents: 121
diff changeset
    63
    EnterFieldGroups can be used as a delegate (of the topView) to forward
claus
parents: 121
diff changeset
    64
    input (entered into the topView) to the currently active field.
claus
parents: 121
diff changeset
    65
claus
parents: 121
diff changeset
    66
    Stepping to previous field is via CursorUp/PreviousField,
claus
parents: 121
diff changeset
    67
    to next field via CursorDown/NextField/Tab.
claus
parents: 121
diff changeset
    68
    Notice, that by default, the editField takes the tab-character as
claus
parents: 121
diff changeset
    69
    a normal character. To step using tab, you have to add the Tab key to the
claus
parents: 121
diff changeset
    70
    fields leaveKeys.
claus
parents: 121
diff changeset
    71
claus
parents: 121
diff changeset
    72
    Instance variables:
claus
parents: 121
diff changeset
    73
claus
parents: 121
diff changeset
    74
	fields          <Collection of EditField>       the fields of the group
claus
parents: 121
diff changeset
    75
claus
parents: 121
diff changeset
    76
	currentField    <EditField>                     the active field
claus
parents: 121
diff changeset
    77
claus
parents: 121
diff changeset
    78
	leaveAction     <nil|Block>                     action to perform, when the
claus
parents: 121
diff changeset
    79
							last field is left by a non-wrap
claus
parents: 121
diff changeset
    80
claus
parents: 121
diff changeset
    81
	wrap            <Boolean>                       if true, non-return next-keys wrap
claus
parents: 121
diff changeset
    82
							back to the first field.
claus
parents: 121
diff changeset
    83
							If false (the default), next in
claus
parents: 121
diff changeset
    84
							the last field is taken as return.
claus
parents: 121
diff changeset
    85
							This is ignored, if no leaveAction was 
claus
parents: 121
diff changeset
    86
							defined.
121
claus
parents: 69
diff changeset
    87
"
claus
parents: 69
diff changeset
    88
!
claus
parents: 69
diff changeset
    89
claus
parents: 69
diff changeset
    90
examples 
claus
parents: 69
diff changeset
    91
"
122
claus
parents: 121
diff changeset
    92
    without a group - user has to enter mouse into the next field to activate it;
claus
parents: 121
diff changeset
    93
    Cursor-keys dont work:
121
claus
parents: 69
diff changeset
    94
claus
parents: 69
diff changeset
    95
	|top panel field1 field2 field3|
claus
parents: 69
diff changeset
    96
claus
parents: 69
diff changeset
    97
	top := StandardSystemView new.
claus
parents: 69
diff changeset
    98
	top extent:200@200.
claus
parents: 69
diff changeset
    99
claus
parents: 69
diff changeset
   100
	panel := VerticalPanelView origin:0.0@0.0 corner:1.0@1.0 in:top.
claus
parents: 69
diff changeset
   101
claus
parents: 69
diff changeset
   102
	panel add:(field1 := EditField extent:(1.0 @ nil)).
claus
parents: 69
diff changeset
   103
	panel add:(field2 := EditField extent:(1.0 @ nil)).
claus
parents: 69
diff changeset
   104
	panel add:(field3 := EditField extent:(1.0 @ nil)).
claus
parents: 69
diff changeset
   105
claus
parents: 69
diff changeset
   106
	top open
claus
parents: 69
diff changeset
   107
claus
parents: 69
diff changeset
   108
claus
parents: 69
diff changeset
   109
    with a group - Return-key or CursorKey enables next field:
122
claus
parents: 121
diff changeset
   110
    (but still, mouse pointer has to be moved into any of the fields,
claus
parents: 121
diff changeset
   111
     because the topView does not forward its input into the fields)
121
claus
parents: 69
diff changeset
   112
claus
parents: 69
diff changeset
   113
	|top panel group field1 field2 field3|
claus
parents: 69
diff changeset
   114
claus
parents: 69
diff changeset
   115
	top := StandardSystemView new.
claus
parents: 69
diff changeset
   116
	top extent:200@200.
claus
parents: 69
diff changeset
   117
claus
parents: 69
diff changeset
   118
	panel := VerticalPanelView origin:0.0@0.0 corner:1.0@1.0 in:top.
claus
parents: 69
diff changeset
   119
claus
parents: 69
diff changeset
   120
	panel add:(field1 := EditField extent:(1.0 @ nil)).
claus
parents: 69
diff changeset
   121
	panel add:(field2 := EditField extent:(1.0 @ nil)).
claus
parents: 69
diff changeset
   122
	panel add:(field3 := EditField extent:(1.0 @ nil)).
claus
parents: 69
diff changeset
   123
claus
parents: 69
diff changeset
   124
	group := EnterFieldGroup new.
claus
parents: 69
diff changeset
   125
	group add:field1; add:field2; add:field3.
claus
parents: 69
diff changeset
   126
claus
parents: 69
diff changeset
   127
	top open
claus
parents: 69
diff changeset
   128
claus
parents: 69
diff changeset
   129
claus
parents: 69
diff changeset
   130
122
claus
parents: 121
diff changeset
   131
    same, enables tabbing via the Tab key:
claus
parents: 121
diff changeset
   132
claus
parents: 121
diff changeset
   133
	|top panel group field1 field2 field3|
claus
parents: 121
diff changeset
   134
claus
parents: 121
diff changeset
   135
	top := StandardSystemView new.
claus
parents: 121
diff changeset
   136
	top extent:200@200.
claus
parents: 121
diff changeset
   137
claus
parents: 121
diff changeset
   138
	panel := VerticalPanelView origin:0.0@0.0 corner:1.0@1.0 in:top.
claus
parents: 121
diff changeset
   139
claus
parents: 121
diff changeset
   140
	panel add:(field1 := EditField extent:(1.0 @ nil)).
claus
parents: 121
diff changeset
   141
	panel add:(field2 := EditField extent:(1.0 @ nil)).
claus
parents: 121
diff changeset
   142
	panel add:(field3 := EditField extent:(1.0 @ nil)).
claus
parents: 121
diff changeset
   143
claus
parents: 121
diff changeset
   144
	group := EnterFieldGroup new.
claus
parents: 121
diff changeset
   145
	group add:field1; add:field2; add:field3.
claus
parents: 121
diff changeset
   146
claus
parents: 121
diff changeset
   147
	field1 leaveKeys:(EditField defaultLeaveKeys copyWith:#Tab).
claus
parents: 121
diff changeset
   148
	field2 leaveKeys:(EditField defaultLeaveKeys copyWith:#Tab).
claus
parents: 121
diff changeset
   149
	field3 leaveKeys:(EditField defaultLeaveKeys copyWith:#Tab).
claus
parents: 121
diff changeset
   150
	top open
claus
parents: 121
diff changeset
   151
claus
parents: 121
diff changeset
   152
claus
parents: 121
diff changeset
   153
claus
parents: 121
diff changeset
   154
    with a group - Return-key or CursorKey enables next field:
claus
parents: 121
diff changeset
   155
    input into topView is forwarded to the group:
claus
parents: 121
diff changeset
   156
claus
parents: 121
diff changeset
   157
	|top panel group field1 field2 field3|
claus
parents: 121
diff changeset
   158
claus
parents: 121
diff changeset
   159
	top := StandardSystemView new.
claus
parents: 121
diff changeset
   160
	top extent:200@200.
claus
parents: 121
diff changeset
   161
claus
parents: 121
diff changeset
   162
	panel := VerticalPanelView origin:0.0@0.0 corner:1.0@1.0 in:top.
claus
parents: 121
diff changeset
   163
claus
parents: 121
diff changeset
   164
	panel add:(field1 := EditField extent:(1.0 @ nil)).
claus
parents: 121
diff changeset
   165
	panel add:(field2 := EditField extent:(1.0 @ nil)).
claus
parents: 121
diff changeset
   166
	panel add:(field3 := EditField extent:(1.0 @ nil)).
claus
parents: 121
diff changeset
   167
claus
parents: 121
diff changeset
   168
	group := EnterFieldGroup new.
claus
parents: 121
diff changeset
   169
	group add:field1; add:field2; add:field3.
claus
parents: 121
diff changeset
   170
claus
parents: 121
diff changeset
   171
	top delegate:group.
claus
parents: 121
diff changeset
   172
	top open
claus
parents: 121
diff changeset
   173
claus
parents: 121
diff changeset
   174
claus
parents: 121
diff changeset
   175
claus
parents: 121
diff changeset
   176
    as above, but close the box when the last field is left:
claus
parents: 121
diff changeset
   177
claus
parents: 121
diff changeset
   178
	|top panel group field1 field2 field3|
claus
parents: 121
diff changeset
   179
claus
parents: 121
diff changeset
   180
	top := StandardSystemView new.
claus
parents: 121
diff changeset
   181
	top extent:200@200.
claus
parents: 121
diff changeset
   182
claus
parents: 121
diff changeset
   183
	panel := VerticalPanelView origin:0.0@0.0 corner:1.0@1.0 in:top.
claus
parents: 121
diff changeset
   184
claus
parents: 121
diff changeset
   185
	panel add:(field1 := EditField extent:(1.0 @ nil)).
claus
parents: 121
diff changeset
   186
	panel add:(field2 := EditField extent:(1.0 @ nil)).
claus
parents: 121
diff changeset
   187
	panel add:(field3 := EditField extent:(1.0 @ nil)).
claus
parents: 121
diff changeset
   188
claus
parents: 121
diff changeset
   189
	group := EnterFieldGroup new.
claus
parents: 121
diff changeset
   190
	group add:field1; add:field2; add:field3.
claus
parents: 121
diff changeset
   191
	group leaveAction:[top destroy].
claus
parents: 121
diff changeset
   192
claus
parents: 121
diff changeset
   193
	top delegate:group.
claus
parents: 121
diff changeset
   194
	top open
claus
parents: 121
diff changeset
   195
claus
parents: 121
diff changeset
   196
claus
parents: 121
diff changeset
   197
claus
parents: 121
diff changeset
   198
    same as above, with Tab-key stepping:
121
claus
parents: 69
diff changeset
   199
claus
parents: 69
diff changeset
   200
	|top panel group field1 field2 field3|
claus
parents: 69
diff changeset
   201
claus
parents: 69
diff changeset
   202
	top := StandardSystemView new.
claus
parents: 69
diff changeset
   203
	top extent:200@200.
claus
parents: 69
diff changeset
   204
claus
parents: 69
diff changeset
   205
	panel := VerticalPanelView origin:0.0@0.0 corner:1.0@1.0 in:top.
claus
parents: 69
diff changeset
   206
claus
parents: 69
diff changeset
   207
	panel add:(field1 := EditField extent:(1.0 @ nil)).
claus
parents: 69
diff changeset
   208
	panel add:(field2 := EditField extent:(1.0 @ nil)).
claus
parents: 69
diff changeset
   209
	panel add:(field3 := EditField extent:(1.0 @ nil)).
claus
parents: 69
diff changeset
   210
claus
parents: 69
diff changeset
   211
	group := EnterFieldGroup new.
claus
parents: 69
diff changeset
   212
	group add:field1; add:field2; add:field3.
claus
parents: 69
diff changeset
   213
	group leaveAction:[top destroy].
claus
parents: 69
diff changeset
   214
122
claus
parents: 121
diff changeset
   215
	field1 leaveKeys:(EditField defaultLeaveKeys copyWith:#Tab).
claus
parents: 121
diff changeset
   216
	field2 leaveKeys:(EditField defaultLeaveKeys copyWith:#Tab).
claus
parents: 121
diff changeset
   217
	field3 leaveKeys:(EditField defaultLeaveKeys copyWith:#Tab).
claus
parents: 121
diff changeset
   218
claus
parents: 121
diff changeset
   219
	top delegate:group.
121
claus
parents: 69
diff changeset
   220
	top open
122
claus
parents: 121
diff changeset
   221
claus
parents: 121
diff changeset
   222
claus
parents: 121
diff changeset
   223
claus
parents: 121
diff changeset
   224
    the next example shows that the input order is defined by the
claus
parents: 121
diff changeset
   225
    order in the group; NOT by the physical layout of the fields in the superview:
claus
parents: 121
diff changeset
   226
claus
parents: 121
diff changeset
   227
	|top panel group field1 field2 field3|
claus
parents: 121
diff changeset
   228
claus
parents: 121
diff changeset
   229
	top := StandardSystemView new.
claus
parents: 121
diff changeset
   230
	top extent:200@200.
claus
parents: 121
diff changeset
   231
claus
parents: 121
diff changeset
   232
	panel := VerticalPanelView origin:0.0@0.0 corner:1.0@1.0 in:top.
claus
parents: 121
diff changeset
   233
claus
parents: 121
diff changeset
   234
	panel add:(field1 := EditField extent:(1.0 @ nil)).
claus
parents: 121
diff changeset
   235
	panel add:(field2 := EditField extent:(1.0 @ nil)).
claus
parents: 121
diff changeset
   236
	panel add:(field3 := EditField extent:(1.0 @ nil)).
claus
parents: 121
diff changeset
   237
claus
parents: 121
diff changeset
   238
	group := EnterFieldGroup new.
claus
parents: 121
diff changeset
   239
	group add:field3; add:field2; add:field1.
claus
parents: 121
diff changeset
   240
	group leaveAction:[top destroy].
claus
parents: 121
diff changeset
   241
claus
parents: 121
diff changeset
   242
	top delegate:group.
claus
parents: 121
diff changeset
   243
	top open
claus
parents: 121
diff changeset
   244
claus
parents: 121
diff changeset
   245
claus
parents: 121
diff changeset
   246
claus
parents: 121
diff changeset
   247
    using a single model for all fields:
claus
parents: 121
diff changeset
   248
    (here, we use a Plug to simulate a more complex model):
claus
parents: 121
diff changeset
   249
claus
parents: 121
diff changeset
   250
	|top panel group field1 field2 field3 model
claus
parents: 121
diff changeset
   251
	 value1 value2 value3|
claus
parents: 121
diff changeset
   252
claus
parents: 121
diff changeset
   253
	top := StandardSystemView new.
claus
parents: 121
diff changeset
   254
	top extent:200@200.
claus
parents: 121
diff changeset
   255
claus
parents: 121
diff changeset
   256
	panel := VerticalPanelView origin:0.0@0.0 corner:1.0@1.0 in:top.
claus
parents: 121
diff changeset
   257
claus
parents: 121
diff changeset
   258
	panel add:(field1 := EditField extent:(1.0 @ nil)).
claus
parents: 121
diff changeset
   259
	panel add:(field2 := EditField extent:(1.0 @ nil)).
claus
parents: 121
diff changeset
   260
	panel add:(field3 := EditField extent:(1.0 @ nil)).
claus
parents: 121
diff changeset
   261
claus
parents: 121
diff changeset
   262
	group := EnterFieldGroup new.
claus
parents: 121
diff changeset
   263
	group add:field1; add:field2; add:field3.
claus
parents: 121
diff changeset
   264
	group leaveAction:[top destroy].
claus
parents: 121
diff changeset
   265
claus
parents: 121
diff changeset
   266
	value1 := 'one'. value2 := 'two'. value3 := 'three'.
claus
parents: 121
diff changeset
   267
claus
parents: 121
diff changeset
   268
	model := Plug new.
claus
parents: 121
diff changeset
   269
	model respondTo:#value1 with:[value1].
claus
parents: 121
diff changeset
   270
	model respondTo:#value1: with:[:arg | value1 := arg].
claus
parents: 121
diff changeset
   271
	model respondTo:#value2 with:[value2].
claus
parents: 121
diff changeset
   272
	model respondTo:#value2: with:[:arg | value2 := arg].
claus
parents: 121
diff changeset
   273
	model respondTo:#value3 with:[value3].
claus
parents: 121
diff changeset
   274
	model respondTo:#value3: with:[:arg | value3 := arg].
claus
parents: 121
diff changeset
   275
claus
parents: 121
diff changeset
   276
	field1 model:model; aspect:#value1; change:#value1:.
claus
parents: 121
diff changeset
   277
	field2 model:model; aspect:#value2; change:#value2:.
claus
parents: 121
diff changeset
   278
	field3 model:model; aspect:#value3; change:#value3:.
claus
parents: 121
diff changeset
   279
claus
parents: 121
diff changeset
   280
	top delegate:group.
claus
parents: 121
diff changeset
   281
	top openModal.
claus
parents: 121
diff changeset
   282
claus
parents: 121
diff changeset
   283
	Transcript showCr:'value1: ' , value1.
claus
parents: 121
diff changeset
   284
	Transcript showCr:'value2: ' , value2.
claus
parents: 121
diff changeset
   285
	Transcript showCr:'value3: ' , value3.
claus
parents: 121
diff changeset
   286
claus
parents: 121
diff changeset
   287
claus
parents: 121
diff changeset
   288
    the above is done automatically for you, if you add inputFields
claus
parents: 121
diff changeset
   289
    to a dialogBox:
claus
parents: 121
diff changeset
   290
claus
parents: 121
diff changeset
   291
	|box model
claus
parents: 121
diff changeset
   292
	 value1 value2 value3|
claus
parents: 121
diff changeset
   293
claus
parents: 121
diff changeset
   294
	box := DialogBox new.
claus
parents: 121
diff changeset
   295
	box extent:200@200.
claus
parents: 121
diff changeset
   296
claus
parents: 121
diff changeset
   297
	value1 := 'one'. value2 := 'two'. value3 := 'three'.
claus
parents: 121
diff changeset
   298
claus
parents: 121
diff changeset
   299
	model := Plug new.
claus
parents: 121
diff changeset
   300
	model respondTo:#value1 with:[value1].
claus
parents: 121
diff changeset
   301
	model respondTo:#value1: with:[:arg | value1 := arg].
claus
parents: 121
diff changeset
   302
	model respondTo:#value2 with:[value2].
claus
parents: 121
diff changeset
   303
	model respondTo:#value2: with:[:arg | value2 := arg].
claus
parents: 121
diff changeset
   304
	model respondTo:#value3 with:[value3].
claus
parents: 121
diff changeset
   305
	model respondTo:#value3: with:[:arg | value3 := arg].
claus
parents: 121
diff changeset
   306
claus
parents: 121
diff changeset
   307
	(box addInputFieldOn:model) aspect:#value1; change:#value1:.
claus
parents: 121
diff changeset
   308
	box addVerticalSpace.
claus
parents: 121
diff changeset
   309
	(box addInputFieldOn:model) aspect:#value2; change:#value2:.
claus
parents: 121
diff changeset
   310
	box addVerticalSpace.
claus
parents: 121
diff changeset
   311
	(box addInputFieldOn:model) aspect:#value3; change:#value3:.
claus
parents: 121
diff changeset
   312
claus
parents: 121
diff changeset
   313
	box open.
claus
parents: 121
diff changeset
   314
claus
parents: 121
diff changeset
   315
	Transcript showCr:'value1: ' , value1.
claus
parents: 121
diff changeset
   316
	Transcript showCr:'value2: ' , value2.
claus
parents: 121
diff changeset
   317
	Transcript showCr:'value3: ' , value3.
38
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
   318
"
4b9b70b2cc87 2.10.3 pre-final version
claus
parents: 7
diff changeset
   319
! !
0
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   320
122
claus
parents: 121
diff changeset
   321
!EnterFieldGroup class methodsFor:'instance creation'!
claus
parents: 121
diff changeset
   322
claus
parents: 121
diff changeset
   323
new
claus
parents: 121
diff changeset
   324
    ^ self basicNew wrap:false
claus
parents: 121
diff changeset
   325
! !
claus
parents: 121
diff changeset
   326
0
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   327
!EnterFieldGroup methodsFor:'adding / removing'!
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   328
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   329
add:aField
122
claus
parents: 121
diff changeset
   330
    |thisIndex next action|
0
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   331
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   332
    fields isNil ifTrue:[
69
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   333
	fields := OrderedCollection new
0
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   334
    ].
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   335
    fields add:aField.
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   336
    thisIndex := fields size.
121
claus
parents: 69
diff changeset
   337
7
15a9291b9bd0 *** empty log message ***
claus
parents: 5
diff changeset
   338
    aField delegate:self.
121
claus
parents: 69
diff changeset
   339
    aField hideCursor.
0
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   340
    aField disable.
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   341
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   342
    "set the fields enableAction to disable active field"
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   343
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   344
    aField enableAction:[
121
claus
parents: 69
diff changeset
   345
"/ Transcript showCr:'enable field with: ' , aField editValue.
69
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   346
	currentField notNil ifTrue:[
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   347
	    currentField disable
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   348
	].
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   349
	currentField := aField
0
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   350
    ].
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   351
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   352
    "set the fields leaveAction to enable next field"
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   353
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   354
    aField leaveAction:[:key |
121
claus
parents: 69
diff changeset
   355
"/ Transcript showCr:'left field with: ' , aField editValue.
69
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   356
	currentField notNil ifTrue:[
121
claus
parents: 69
diff changeset
   357
	    currentField disable.
claus
parents: 69
diff changeset
   358
	    currentField hideCursor.
69
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   359
	].
122
claus
parents: 121
diff changeset
   360
claus
parents: 121
diff changeset
   361
	action := key.
121
claus
parents: 69
diff changeset
   362
	((key == #CursorUp) or:[key == #PreviousField]) ifTrue:[
69
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   363
	    (thisIndex == 1) ifTrue:[
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   364
		next := fields size
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   365
	    ] ifFalse:[
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   366
		next := thisIndex - 1
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   367
	    ]
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   368
	].
122
claus
parents: 121
diff changeset
   369
	((key == #CursorDown) 
claus
parents: 121
diff changeset
   370
	or:[key == #NextField
claus
parents: 121
diff changeset
   371
	or:[key == #Tab]]) ifTrue:[
69
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   372
	    (thisIndex == (fields size)) ifTrue:[
122
claus
parents: 121
diff changeset
   373
		wrap ifFalse:[
claus
parents: 121
diff changeset
   374
		    action := #Return.
claus
parents: 121
diff changeset
   375
		] ifTrue:[
claus
parents: 121
diff changeset
   376
		    next := 1
claus
parents: 121
diff changeset
   377
		].
69
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   378
	    ] ifFalse:[
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   379
		next := thisIndex + 1
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   380
	    ]
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   381
	].
122
claus
parents: 121
diff changeset
   382
	(action == #Return) ifTrue:[
69
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   383
	    (thisIndex == (fields size)) ifTrue:[
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   384
		leaveAction notNil ifTrue:[
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   385
		    leaveAction value.
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   386
		    currentField := nil
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   387
		] ifFalse:[
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   388
		    next := 1
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   389
		]
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   390
	    ] ifFalse:[
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   391
		next := thisIndex + 1
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   392
	    ]
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   393
	].
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   394
	next notNil ifTrue:[
121
claus
parents: 69
diff changeset
   395
	    self makeActive:(fields at:next) 
69
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   396
	]
121
claus
parents: 69
diff changeset
   397
    ].
claus
parents: 69
diff changeset
   398
claus
parents: 69
diff changeset
   399
    fields size == 1 ifTrue:[
claus
parents: 69
diff changeset
   400
	"the first one"
claus
parents: 69
diff changeset
   401
	self makeActive:aField
0
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   402
    ]
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   403
! !
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   404
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   405
!EnterFieldGroup methodsFor:'accessing'!
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   406
122
claus
parents: 121
diff changeset
   407
wrap:aBoolean
claus
parents: 121
diff changeset
   408
    "specifies if leaveing the last field via non-Return
claus
parents: 121
diff changeset
   409
     should wrap back to the first, or leave the group"
claus
parents: 121
diff changeset
   410
claus
parents: 121
diff changeset
   411
    wrap := aBoolean
claus
parents: 121
diff changeset
   412
!
claus
parents: 121
diff changeset
   413
0
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   414
leaveAction:aBlock
121
claus
parents: 69
diff changeset
   415
    "set the action to perform when the last field is left.
claus
parents: 69
diff changeset
   416
     Usually, this is to accept the values of all fields and perform
claus
parents: 69
diff changeset
   417
     some additional processing (such as closing a dialog)."
claus
parents: 69
diff changeset
   418
0
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   419
    leaveAction := aBlock
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   420
! !
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   421
121
claus
parents: 69
diff changeset
   422
!EnterFieldGroup methodsFor:'misc'!
claus
parents: 69
diff changeset
   423
claus
parents: 69
diff changeset
   424
activateFirst
claus
parents: 69
diff changeset
   425
    "pass controll to my first field"
claus
parents: 69
diff changeset
   426
claus
parents: 69
diff changeset
   427
    fields notNil ifTrue:[
claus
parents: 69
diff changeset
   428
	self makeActive:(fields first)
claus
parents: 69
diff changeset
   429
    ]
claus
parents: 69
diff changeset
   430
! !
claus
parents: 69
diff changeset
   431
claus
parents: 69
diff changeset
   432
!EnterFieldGroup methodsFor:'private'!
0
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   433
7
15a9291b9bd0 *** empty log message ***
claus
parents: 5
diff changeset
   434
makeActive:aField
121
claus
parents: 69
diff changeset
   435
    "make a specific field the active one"
claus
parents: 69
diff changeset
   436
7
15a9291b9bd0 *** empty log message ***
claus
parents: 5
diff changeset
   437
    currentField notNil ifTrue:[
121
claus
parents: 69
diff changeset
   438
	currentField disable.
claus
parents: 69
diff changeset
   439
	currentField hideCursor.
claus
parents: 69
diff changeset
   440
	currentField hasKeyboardFocus:false.
7
15a9291b9bd0 *** empty log message ***
claus
parents: 5
diff changeset
   441
    ].
15a9291b9bd0 *** empty log message ***
claus
parents: 5
diff changeset
   442
    currentField := aField.
15a9291b9bd0 *** empty log message ***
claus
parents: 5
diff changeset
   443
    currentField enable.
121
claus
parents: 69
diff changeset
   444
    currentField showCursor.
claus
parents: 69
diff changeset
   445
    currentField hasKeyboardFocus:true.
claus
parents: 69
diff changeset
   446
! !
7
15a9291b9bd0 *** empty log message ***
claus
parents: 5
diff changeset
   447
121
claus
parents: 69
diff changeset
   448
!EnterFieldGroup methodsFor:'event forwarding'!
claus
parents: 69
diff changeset
   449
claus
parents: 69
diff changeset
   450
handlesKeyPress:key inView:aView
claus
parents: 69
diff changeset
   451
    "query from event processor: am I interrested in key-events ?
claus
parents: 69
diff changeset
   452
     yes I am (to forward it to the active field)."
claus
parents: 69
diff changeset
   453
0
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   454
    ^ true
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   455
!
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   456
121
claus
parents: 69
diff changeset
   457
handlesButtonPress:button inView:aView
claus
parents: 69
diff changeset
   458
    "query from event processor: am I interrested in button-events ?
claus
parents: 69
diff changeset
   459
     yes I am (to activate the clicked-on field)."
59
450ce95a72a4 *** empty log message ***
claus
parents: 38
diff changeset
   460
121
claus
parents: 69
diff changeset
   461
   ^ true
59
450ce95a72a4 *** empty log message ***
claus
parents: 38
diff changeset
   462
!
450ce95a72a4 *** empty log message ***
claus
parents: 38
diff changeset
   463
121
claus
parents: 69
diff changeset
   464
handlesButtonShiftPress:button inView:aView
claus
parents: 69
diff changeset
   465
    "query from event processor: am I interrested in button-events ?
claus
parents: 69
diff changeset
   466
     yes I am (to activate the clicked-on field)."
59
450ce95a72a4 *** empty log message ***
claus
parents: 38
diff changeset
   467
121
claus
parents: 69
diff changeset
   468
    ^ true
59
450ce95a72a4 *** empty log message ***
claus
parents: 38
diff changeset
   469
!
450ce95a72a4 *** empty log message ***
claus
parents: 38
diff changeset
   470
7
15a9291b9bd0 *** empty log message ***
claus
parents: 5
diff changeset
   471
keyPress:key x:x y:y view:aView
121
claus
parents: 69
diff changeset
   472
    "key-press in any field - forward the key to the active field"
0
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   473
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   474
    currentField notNil ifTrue:[
69
2b72a20e61c2 *** empty log message ***
claus
parents: 59
diff changeset
   475
	currentField keyPress:key x:0 y:0
0
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   476
    ]
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   477
!
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   478
7
15a9291b9bd0 *** empty log message ***
claus
parents: 5
diff changeset
   479
buttonPress:button x:x y:y view:aView
121
claus
parents: 69
diff changeset
   480
    "clicking on a field activates it and forwards the click to it"
claus
parents: 69
diff changeset
   481
7
15a9291b9bd0 *** empty log message ***
claus
parents: 5
diff changeset
   482
    self makeActive:aView.
15a9291b9bd0 *** empty log message ***
claus
parents: 5
diff changeset
   483
    aView buttonPress:button x:x y:y
0
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   484
!
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   485
7
15a9291b9bd0 *** empty log message ***
claus
parents: 5
diff changeset
   486
buttonShiftPress:button x:x y:y view:aView
121
claus
parents: 69
diff changeset
   487
    "clicking on a field activates it and forwards the click to it"
claus
parents: 69
diff changeset
   488
7
15a9291b9bd0 *** empty log message ***
claus
parents: 5
diff changeset
   489
    self makeActive:aView.
0
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   490
    aView buttonShiftPress:button x:x y:y
e6a541c1c0eb Initial revision
claus
parents:
diff changeset
   491
! !