Add a View

Synopsis

LAYE/['layout name',]ADD,'view name',X1,Y1,X2,Y2[,SAVE[,'new layout name']][,IFERR,label:]

Description

Adds a previously defined view to a layout.

You place the added view by defining a location in CRT units where 0,0 is the lower left hand corner of the screen, and 1,1 is the upper right hand corner of the screen.

Parameters

Parameter

Description

'layout name'

A string or string variable which represents the name of the layout to be edited. If no name is specified, the active layout is edited.

ADD

Minor word which indicates that a view be added to the layout.

'view name'

A string or string variable which represents the name of an existing view which is added to the layout.

X1,Y1,X2,Y2

Numerical values between zero and one inclusive which represent the diagonal corners of the view window. The values are in CRT units. X1 and Y1 represent one corner, and X2 and Y2 represent the other corner of the view window. The values may represent any two diagonal corners of the window, and the order of specification has no effect on the widow shape.

SAVE

Minor word which indicates that the layout is to be saved with the current edits. All active views are also saved.

'new layout name'

A string or string variable which represents the new name of the layout as it is being saved. If no new name is specified, the layout is saved using its original name.

IFERR,label:

A label to which program execution jumps if an error occurs during editing or saving the layout.

Parameter	Description
'layout name'	A string or string variable which represents the name of the layout to be edited. If no name is specified, the active layout is edited.
ADD	Minor word which indicates that a view be added to the layout.
'view name'	A string or string variable which represents the name of an existing view which is added to the layout.
X1,Y1,X2,Y2	Numerical values between zero and one inclusive which represent the diagonal corners of the view window. The values are in CRT units. X1 and Y1 represent one corner, and X2 and Y2 represent the other corner of the view window. The values may represent any two diagonal corners of the window, and the order of specification has no effect on the widow shape.
SAVE	Minor word which indicates that the layout is to be saved with the current edits. All active views are also saved.
'new layout name'	A string or string variable which represents the new name of the layout as it is being saved. If no new name is specified, the layout is saved using its original name.
IFERR,label:	A label to which program execution jumps if an error occurs during editing or saving the layout.