A scrollable region is a data form item that allows the user to enter many lines of the same type of data. Use a scrollable region when you want to store data as an array.
A scrollable region appears on the screen as multiple, identical rows of prompts and fields in a rectangular region on the data form. When you place a data field within a scrollable region, the field is repeated in each row of the region.
Figure 10.1 shows a data form with a scrollable region. This scrollable region consists of two fields: a name field and a phone number field. These fields are repeated on each of the six visible rows of the scrollable region. Each field makes up one data column on the scrollable region. In this example, there are two data columns.
Underlying the scrollable region are its data rows. The number of data rows equals the maximum number of entries the user can make in the scrollable region. A scrollable region can contain more rows of data than can be visible at once. The user can scroll through all the data rows specified for the scrollable region. For instance, if you define the region to have 25 scrollable data rows, the user could enter up to 25 name/phone number combinations. In the example below, only six rows of data are visible at any one time. When the user scrolls, the information from the underlying data variables scrolls into and out of the scrollable region data fields.
Fields on the scrollable region are referenced by their data row and data column position in the scrollable region. Data rows and data columns are numbered starting from zero. Thus, the phone number field in the lower-right corner of the scrollable region is at position (5,1). The last name field in the scrollable region is at position (24, 0).
Figure 10.1: A Scrollable Region on a Data Form
How the User Enters Information in Scrollable Regions
How Form Processing Works Within Scrollable Regions
Features and Options for Scrollable Regions
