returnInField

Sent to a field when the selection is in the field and the user presses the Return key.

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:

# Syntax

returnInField

# Examples

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

# Description

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.

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. pass 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.

# Tags

ui,

# See

- **keyword:** field, selection - **property:** menuMode - **message:** enterInField - **object:** button - **glossary:** handler, pass, message, combo box, message path, object - **control structure:** pass