Release 10.1A: OpenEdge Development:
Programming Interfaces

> ## Down frames

> Like an interactive display, a frame is the data container for reports. However, unlike a display frame, a report usually contains more than one iteration of data. A frame that can contain more than one iteration of data is known as a down frame. (Sometimes a frame with a single iteration of data is called a one-down frame.)

> Early on, you learned that a frame is a container for field-level widgets (data widgets, action widgets, graphic widgets). Actually, it’s a bit more complicated than that. All the widgets included in a one-down frame are contained in a special widget called a field-group widget. The frame contains the field-group widget. When you display several iterations of data, the widgets of each iteration belong to a single field-group widget, and the frame contains the set of field group widgets.

> The behind-the-scenes work of the field-group widget is rarely something that you need to track. The explanation above simply serves to explain the mechanics of a down frame in terms of the programming model.

> The default frame of an iterating control block, like `FOR EACH`, is a down frame. You can also specify a down frame with the `DOWN` keyword of the frame phrase. `DOWN` used alone indicates that you want Progress to fit as many iterations in the frame as the screen can hold. Here is an example:

>     DEFINE FRAME Frame1
>       sports.Customer.Name
>         WITH DOWN CENTERED THREE-D.

> Specifying an integer before `DOWN` indicates the maximum number of iterations the frame can hold. Here is an example:

>     DEFINE FRAME Frame1
>       sports.Customer.Name
>         WITH 12 DOWN CENTERED THREE-D.

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