Error getting tags :
error 404Error getting tags :
error 404 returnInField | revDocs | RunRev
Welcome Guest (Log in)
Product Edition
Version
returnInField
Basics
Expander triangle
Type
Message
Syntax
returnInField
Introduced
1.0
Environment
Desktop, Web and Server
Platform Support
MacOS,Mac OS X,Windows,Linux
Security
None required
Summary
Sent to a field when the selection is in the field and the user presses the Return key.
Examples

on returnInField -- automatically re-sort a field when a line is added
sort lines of the target
end returnInField

Additional Comments
Expander triangle

Handle the returnInField message when you want to perform an action (such as adding a column of figures) when the user presses Return in a field.

Comments:

The Return key (confusingly labeled "Enter" on some keyboards) is usually located above the right-hand Shift key. It is the key you press to go to a new line.

If the returnInField handler does not pass the message or send it to a further object in the message path, the keypress has no effect. Passing the message allows the keypress to have its normal effect.

The returnInField message is sent to buttons whose menuMode is "comboBox", since the type-in box in a combo box behaves like a field.

If there is no selection or insertion point in any field and the user presses Return, the returnKey message is sent instead of returnInField.

User Comments
Expander triangle
User thumbnail
Peter Brigham
StarStarStarStarStar
Jul 23, 2009
If there is no selection or insertion point in any field and a locked but focusable field has the focus, the returninfield message is sent to the field instead of the returnkey message
User thumbnail
Peter Brigham
StarStarStarStarStar
Aug 1, 2009
The last sentence should be amended slightly. If there is no selection or insertion point in any field, but a field has the focus (for instance, its traversalon is might be true true but the field is locked), then the returninfield message is sent to the field, not the returnkey.