Returns a DECIMAL value that is the column position of the left corner of a frame within its window.
Note: Does not apply to SpeedScript programming.
Syntax
FRAME-COL [ ( frame ) ]
frame
The name of the frame whose column position you are trying to determine. If you do not supply a frame name, the FRAME-COL function uses the default frame for the block it is in. If the FRAME-COL function is in a DO block, the function uses the default frame scoped to the block containing the DO block.
Example
This procedure displays Customer information in one frame, then displays Order information in an overlay frame. FRAME-ROW places the overlay frame on the ninth row of the second column. FRAME-COL places the overlay frame on the first column of the first frame.
r-frcol.p
FOR EACH Customer NO-LOCK:
DISPLAY Customer WITH FRAME cust-frame 2 COLUMNS
TITLE "CUSTOMER INFORMATION".
FOR EACH Order OF Customer NO-LOCK:
DISPLAY Order.OrderNum Order.OrderDate Order.ShipDate Order.PromiseDate
Order.Carrier Order.Instructions Order.PO
WITH 2 COLUMNS 1 DOWN OVERLAY TITLE "CUSTOMER'S ORDERS"
ROW FRAME-ROW(cust-frame) + 8 COLUMN FRAME-COL(cust-frame) + 1.
END.
END.
Notes
The FRAME-COL function returns a value of 0 if the frame you specify is not in view when the AVM evaluates the function.
To convert the decimal value returned by FRAME-COL to an integer value, use the INTEGER function.