Release 10.1A: OpenEdge Development:
Progress 4GL Reference

> ## 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.

>     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 © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095