escape

Returns to previous escape level.

Available in:

Apps (win)	Apps (char)	Reportwriter	RPC	Standalone PL
X	X	X	X	X

Syntax

void escape([input])
keyword      input

Description

Returns through multiple escape levels. Currently two are available:

Application --- On entry to the application.
Window --- On entry to the window.

Typically, escape() is used in application key triggers to return to the window trigger immediately following the current go_field() or input() statement. In reports, escape() exits the report and returns to the operating system.

input (optional) if placed in a validation or key trigger, specifies that the execution continues after the [raw_]input() call. (This action resolves the problem of exiting input (quit key) from a not-null field that is empty; for example, escape(input) in a prevalidation trigger.) Otherwise, the execution goes to window top.

Example

Assigned to [F3] (End) in the application builder, forces an exit to the window trigger if the go_field() function is used:

escape();