Returns an INTEGER value that represents the number
of iterations in a frame.
Note: Does not apply
to SpeedScript programming.
Syntax
-
frame
- The name of the frame whose number down you are trying to determine.
If you do not supply a frame name, the FRAME-DOWN function uses
the default frame for the block it is in. If the FRAME-DOWN function
is in a DO block, the function uses the default frame scoped to
the block containing the DO block.
Example
This
procedure displays Customers in a frame. When the frame is full,
the procedure prompts "Do you want to see the next page?" The procedure
recognizes that the frame is full when the value of FRAME-LINE (current
logical line number) equals the value of FRAME-DOWN (number of iterations
in the frame).
r-frdown.p
DEFINE VARIABLE ans AS LOGICAL NO-UNDO.
REPEAT:
FIND NEXT Customer NO-LOCK.
DISPLAY Customer.CustNum Customer.Name.
IF FRAME-LINE = FRAME-DOWN THEN DO:
MESSAGE "Do you want to see the next page ?" UPDATE ans.
IF NOT ans THEN LEAVE.
END.
END.
|
Note
The FRAME-DOWN
function returns a value of 0 if used with a single frame or if
the frame is not in view when the function is evaluated.