Overview | Statement List | Example
LAYV/['layout name',]variable list[,IFERR,label:]
Returns the parameters of a specified layout to a list of variables. Some of the variables in the list must be declared as arrays. The parameter returned depends upon its field position in the list.
The numerical array which represents the location of each view in the layout requires four array positions for each view. The first two positions represent the location of the lower left-hand corner of the view (X1,Y1) in screen coordinates. The second two positions represent the location of the upper right-hand corner of the view (X2,Y2). The screen coordinates for the lower left-hand corner of the screen are (0,0) and for the upper right-hand corner are (1,1).
If certain parameters are not desired, the field must be defined using two commas (,,). However, once you have specified the last desired parameter, do not use commas to define the remaining positions. For example, if you wished to only verify the name of each view and the number of views in the layout, you would specify
LAYV/VNAM,,NUMVW,IFERR,label:
where VNAM is the view name; ,, represents the omitted view location parameter; and NUMVW represents the number of views in the layout. The variable list is as shown in the table below.
|
Position |
Parameter |
Data Type |
|
1 |
Name of each view in the layout. |
String array |
|
2 |
Location of each view in the layout. Four array positions are required for each view. |
Num. array |
|
3 |
Number of views in the layout. |
Number |
|
4 |
Work view name. A value is returned only if verifying an active layout. |
String variable |
|
Parameter |
Description |
|
'layout name' |
A string or string variable which represents the name of the layout being verified. The layout does not need to be active. If no layout name is specified, the curSpecifies a label to which program execution jumps if an error occurs in accessing the layout.rent layout is verified. |
|
variable list |
A list of variables to which the layout parameters are assigned. |
|
IFERR,label: |
Specifies a label to which program execution jumps if an error occurs in accessing the layout. |