FRAME-COL function

Returns a DECIMAL value that is the column position of the left corner of a frame within its window.

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.

See also

Frame phrase, FRAME-DOWN function, FRAME-LINE function, FRAME-ROW function, INTEGER function