Autopage Command

Obsolete

This command is obsolete. It is valid only in character-mode DataFlex or BasicReport objects. There is no specific replacement for this command. The functionality that this command performed is integrated into modern Data Entry Object (DEO) classes.

Purpose

To imply image windows consecutively for addressing by succeeding window addressing commands that omit explicit window references.

Syntax

autopage
pagename[###]

If ### is omitted, autopaging will begin with the first window of pagename.

What It Does

Autopage is a programming convenience that makes it unnecessary to refer explicitly to windows when using print. It is useful where a series of such commands addresses the windows of one or more images consecutively.

Autopage supplies implicit window references to these commands in the order in which they appear in pagename, from left to right, going down the page from top to bottom.

Autopage may be used in either of two ways:

With the image name only:

autopage vendor
print vend.name
print vend.address
print vend.city

Here, three print commands access the first three windows of an image named vendor. The equivalent commands without autopage would read as follows:

print vend.name to vendor.1
print vend.address to vendor.2
print vend.city to vendor.3

With the image name and starting window:
```
autopage employee 6
print emp.fica
print emp.withholding
```
Here, autopage covers only part of an image (employee), starting with the sixth window. The equivalent commands without autopage would be:
```
print emp.fica to employee.6
print emp.withholding to employee.7
```

Notes

Window addressing commands that rely on autopage must address windows in the order in which they appear, with no gaps. However, autopage does not have to begin with the first window in an image, nor end with the last one.
Commands that address windows explicitly may be intermingled among commands that rely on autopage without affecting autopage's window counter.
In the report object, each procedure_section command supplies an automatic autopage command.