AUTO-RETURN attribute

Specifies the behavior that occurs when a user types the last allowable character in the widget.

Data type:

LOGICAL

Access:

Readable/Writeable

Applies to:

BROWSE widget (column), FILL-IN widget

The FORMAT attribute controls the number of characters that a user can enter in the widget. By default, if the user attempts to enter more characters than the number allowed in the widget, the AVM beeps and ignores characters. You can use the AUTO-RETURN attribute to alter this behavior only if the DATA-ENTRY-RETURN attribute of the SESSION handle is TRUE.

If DATA-ENTRY-RETURN and AUTO-RETURN are TRUE and a user types the last character in a field, a LEAVE event occurs and input focus moves to the next widget in the tab order. If the widget is the last widget in the tab order, a GO event occurs for the current frame. This behavior is the same as pressing RETURN or TAB in the field when the DATA-ENTRY-RETURN attribute is TRUE.

For browse columns, if AUTO-RETURN is TRUE, when the user enters the last allowable character in a browse-cell, the AVM behaves as if the user pressed the RETURN key.