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 ARRAY is a special case of the INPUT statement which allows user to input data from a screen array into a program array.
|
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 ARRAY statement is used to assign values entered to a screen array to one or more record of a program array. Optional clauses can be included into this statement to control the process of input. To use the INPUT ARRAY statement:
Create a form file and specify a screen array in it, compile the form file.
Declare an ARRAY OF RECORD 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 ARRAY statement to assign values entered into the screen array to the program array elements.
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 in the form specification file)
you use the INPUT statement with the WITHOUT DEFAULTS keywords
The cursor is moved to the first field (the order of fields is specified by the Binding clause of the INPUT statement)
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 ARRAY 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 ARRAY statement must always have the Binding clause, where the screen array fields are associated with the program array elements; it can also have such optional clauses:
ATTRIBUTE clause
HELP clause
INPUT ARRAY control block
The INPUT ARRAY statement can include the CONTINUE INPUT and EXIT INPUT statements. If the INPUT ARRAY statement contains at least one INPUT control clause, the end of the INPUT ARRAY statement must be marked with the help of the END INPUT keywords.