basic.heading

Statement/BASIC Program, Releases: AP, AP 6.1, and R83

Defines report heading.

Syntax

heading string.expression heading '{{text} {'options'}...}'

Description

designates a text string composed of literals and special options to output at the top of each page.

The 'heading' expression is any valid literal string, string expression, or variable. A literal string must be enclosed in either double-quotes (') or backslahes (\) since 'heading' options must be enclosed within single quotes, to distinguish them from text. Multiple options may be enclosed in the same set of single quotes.

The 'heading' may be changed by a new 'heading' statement, and the new 'heading' is output at the beginning of the next page. The very first time the 'heading' is activated, it is output directly on the screen.

The 'page' statement is used to force pagination.

The 'system' function maintains line and page counters while 'heading' and 'footing' are active.

Options

* see 'options: heading'.

Example

heading ''lc'page 'pn' printed at 'tlc' this
end into shredder first.'l''

page 1 printed at 10:22:30 29 feb 1992
this end into shredder first

head = \'c'this is a heading'l'\
heading head

In this example, the heading option string is assigned to a variable
('head') and subsequently assigned as the heading.

See Also

Command Name Type Description
basic.crt Statement Outputs expression to crt.
basic.page Statement Forces page eject.
basic.statements Definition Definition of statements and functions.
access.break-on Modifier Creates control break in Access reports.
heading.options Definition Description of heading options.
basic.footing Statement Defines report footing.
access.roll-on Modifier creates a visual 'break' in output data when the value of a specified attribute changes, an improvement over the 'break-on' command.
basic.printer Statement Toggles crt/Spooler output or closes entry.
basic.system Function Displays status of system-controlled variables.

User Comments

What do you think?

Share your experience or ask a question by using the form below.

Login to leave your comments.