FRAME-DOWN function

FRAME-DOWN function

Returns an INTEGER value that represents the number of iterations in a frame.

Note: Does not apply to SpeedScript programming.

Syntax
FRAME-DOWN [ ( frame ) ] 
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.

See also

Frame phrase, FRAME-COL function, FRAME-LINE function, FRAME-ROW function

FRAME-DOWN [ ( `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.

OpenEdge Release 10.2B