To meet your needs, we constantly work to improve Querix products.
This means that Lycia documentation is developing as well.
In case you have found a certain dissonance between the provided information and the actual behavior of Lycia 3 and/or your applications, please, let us know about this via documentation@querix.com so that we can introduce the necessary changes to our documentation.
Thank you for your attention and cooperation.
INPUT statement is used to perform data entry into form fields.
|
Element |
Description |
|
INPUT Binding Clause |
The clause that associates the variables with the input fields, It is the only obligatory clause |
|
ATTRIBUTE Clause |
An optional ATTRIBUTE clause where the attributes for the fields used for input can be specified |
|
HELP Clause |
An optional HELP clause where the help number for the input can be specified |
|
INPUT Control Block |
An optional block which controls the process of input |
The INPUT statement assigns the values entered into form fields to the corresponding program variables. This statement may include clauses that specify the actions which 4GL should perform before or after input, clauses that are executed only under certain conditions (such as cursor movement or when some actions are performed by the user), etc.
To use the INPUT statement, follow these steps:
Create a form file and specify one or more text fields in this file, compile the form file.
Declare program variables by means of the DEFINE statement
Open the form either with the help of the OPEN FORM and DISPLAY FORM statements or with the help of the OPEN WINDOW … WITH FORM statement.
Use the INPUT statement to assign values entered into the form fields to the variables.
When the INPUT statement is encountered, it triggers the following actions:
The default values are displayed to the form fields. The values are not displayed if:
there are no default values assigned to these fields (you may assign default value to a field using the form specification file)
you use the INPUT statement with the WITHOUT DEFAULTS
The cursor is moved to the first field (the order of fields is specified by the INPUT statement either explicitly or implicitly)
The user is allowed to perform input either in any order or in the order specified in the INPUT control clause
The value entered by the user is assigned to the corresponding variable when the cursor leaves the field, or if the Accept key is pressed.
When 4GL encounters the INPUT statement, the most recently displayed form or the form in the current window is activated. It is deactivated when the input is complete.
The INPUT statement must always have the Binding clause, where the form fields are associated with the program variables; it can also have such optional clauses:
ATTRIBUTE clause
HELP clause
INPUT control clauses:
BEFORE INPUT
BEFORE FIELD
ON KEY, ON ACTION
AFTER FIELD
AFTER INPUT
The INPUT statement can include the CONTINUE INPUT and EXIT INPUT statements. If the INPUT statement contains at least one INPUT control clause, the end of the INPUT statement must be indicated with the help of the END INPUT keywords.