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.
DISPLAY ARRAY statement is a special case of the DISPLAY statement which includes most of the additional clauses common for INPUT and INPUT ARRAY statement as well as its own additional clauses.
|
Element |
Description |
|
Binding Clause |
This is an obligatory clause which specifies the program array and the record array to which it must be displayed |
|
ATTRIBUTE Clause |
An optional ATTRIBUTE clause where the attributes for the fields used in the DISPLAY ARRAY statement can be specified |
|
HELP Clause |
An optional HELP clause where the help number for the DISPLAY ARRAY statement can be specified |
|
WITHOUT SCROLL clause |
This optional clause consists of the WITHOUT SCROLL keywords. |
|
INPUT Control Block |
An optional DISPLAY control block which controls the display of the data |
DISPLAY ARRAY statement is used to display program arrays to screen arrays; it may include optional clauses.
To use the DISPLAY ARRAY statement, follow these steps:
Specify a screen array in a form specification file
DEFINE an ARRAY of program records. The members of the records must match the fields of the previously specified screen array in order, number and data types
Open and display the form that contains the specified screen array (you may use the OPEN FORM and then the DISPLAY FORM statements or the OPEN WINDOW ... WITH FORM statement)
Populate the program array with the data to be displayed
Call the set_count(i) built-in function. Here, "i" is the number of the records filled with data
Use the DISPLAY ARRAY statement to display these data to a screen array
The set_count() function specifies the initial value for arr_count() function. If it is not set, no data will be displayed. For detailed information, see the Querix reference on built-in functions.
The data types of the values in each record should correspond to the data types of the fields of the screen array. The size of screen array determines the number of program records 4GL can display at a time. The size of a program array determines the number of data it can store. If the size of a program array is larger than the size of a screen array, the user can scroll through the rows in the form.
DISPLAY ARRAY statement has the following effect:
The values of the program array are displayed to the fields of the screen array
The cursor is moved to the first field of the first screen record
The user is expected to press either scroll key or accept key.
DISPLAY ARRAY statement is not terminated until the Accept or Interrupt key is pressed, unless it includes the WITHOUT SCROLL keywords.
The values are displayed by means of the DISPLAY ARRAY statement in the same way as by the DISPLAY statement:
Numbers are right-justified, if a number does not fit the field length, an asterisk is put in the field instead. (currently 4GL does not display anything)
Literal strings and TEXT values are left-justified, if a literal string is longer than the field, the superfluous symbols are truncated from the right
BYTE values cannot be displayed with the help of DISPLAY statement, the field will display <byte value> instead. To display a value of BYTE data type use PROGRAM statement.