Progress
Language Reference


FRAME-DOWN Function

Interfaces
OS
SpeedScript
All
All
No

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

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.

REPEAT:
  FIND NEXT customer.
  DISPLAY cust-num 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


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095