Progress
Language Tutorial
for Character
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:
Specifying an integer before DOWN indicates the maximum number of iterations the frame can hold. Here is an example:
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |