Pageable Maps › Areas of Pageable Maps

Areas of Pageable Maps

A pageable map is divided into three areas, as illustrated in the following screen:

EMPLOYEE PERSONAL DATA


EMPLOYEE NAME:  JANE              FERNDALE
EMPLOYEE NUMBER:  0032                 SOCIAL SECURITY NUMBER:  034-56-7890
EMPLOYEE NAME:  TOM               FITZHUGH
EMPLOYEE NUMBER:  0081                 SOCIAL SECURITY NUMBER:  112-34-5678
EMPLOYEE NAME:  GEORGE            FONRAD
EMPLOYEE NUMBER:  0045                 SOCIAL SECURITY NUMBER:  092-34-7890
EMPLOYEE NAME:  ROBIN             GARDNER
EMPLOYEE NUMBER:  0053                 SOCIAL SECURITY NUMBER:  022-34-4444
EMPLOYEE NAME:  JENNIFER          GARFIELD
EMPLOYEE NUMBER:  0003                 SOCIAL SECURITY NUMBER:  021-99-4516




PAGE:  0004

Three Areas of a Pageable Map

• The header area (optional) is a rectangular area located across the top of the screen that contains one or more rows of map fields associated with header information. The header area information is displayed whenever the map is displayed.
• The footer area (optional) is a rectangular area located across the bottom of the screen that contains one or more rows of map fields associated with footer information. The footer information is displayed whenever the map is displayed.
• The detail area (required) is a rectangular area located across the middle of the screen that contains the detail occurrence for the map.

  The set of fields in the detail occurrence is defined in the detail area only once. At runtime, the number of detail occurrences that are displayed in the detail area depends on the space available on the screen after accounting for the header and footer information.

Examples of each Area

For example, a pageable map used to display a department record and all associated employee records might contain the following information:

• Header area—The title of the map and department information
• Footer area—A message field, a page field to display the current page number, and literal fields with information about how to page through the map
• Detail area—Detail occurrences of employee information

What is a Map Page?

The term map page refers to a runtime display made up of the header and footer map fields and a page of detail occurrences. The page of occurrences that is displayed at any given time is determined by the value of the system $PAGE field. For example, if a department with 25 employees is displayed on a pageable map that can hold a maximum of 10 employee occurrences, the value in the system $PAGE field determines the occurrences that are displayed:

• If $PAGE equals 1, occurrences 1 through 10 are displayed.
• If $PAGE equals 2, occurrences 11 through 20 are displayed.
• If $PAGE equals 3, occurrences 21 through 25 are displayed.

The value in the $PAGE field can be specified by the operator or by the dialog or program. The current value in the system $PAGE field can be displayed on a map by associating $PAGE with a field on the pageable map that is associated with the system $PAGE field.