SCROLLGRID item type

SCROLLGRID item basics

A SCROLLGRID form item type defines a grid to show a scrolling list of data records in a set of positioned form fields.

Defining an SCROLLGRID

The SCROLLGRID form item declares a formatted text block defining the dimensions and the position of the logical elements of a screen for a multi-record presentation.

A SCROLLGRID is similar to the GRID, except that you can only specify form fields, that repeat on several "row-templates", in order to design a multiple-record view that appears with a vertical scrollbar.

Note: When using a SCROLLGRID container, you cannot set the GRIDCHILDRENINPARENT attribute. This attribute makes sense only for a scrollgrid defined with a layout tag contained in a GRID area.

The same layout rules apply as in a GRID container.

By default, a SCROLLGRID container is not resizable in height. Use the WANTFIXEDPAGESIZE=NO attribute to allow the scrollgrid to stretch vertically.

Some front-ends support different presentation and behavior options, which can be controlled by a STYLE attribute. For more details, see Common style attributes.

Where to use a SCROLLGRID

Within a grid-based layout, a SCROLLGRID form item can be defined in two different ways:

As a SCROLLGRID container in a LAYOUT tree.
As a <SCROLLGRID > layout tag with a SCROLLGRID item definition in the ATTRIBUTES section.

SCROLLGRID view programming

A SCROLLGRID is similar to a TABLE form item in terms of list programming. For more details about list view programming, see Table views.