UNDERLINE statement

Underlines a field or variable, using the next display line for the underline.

Note: Does not apply to SpeedScript programming.

Syntax

UNDERLINE [ STREAM stream | STREAM-HANDLE handle ]
           field ... [ frame-phrase ]
STREAM stream

Specifies the name of a stream. If you do not name a stream, the AVM uses the unnamed stream. See the DEFINE STREAM statement reference entry and the chapter on alternate I/O sources in OpenEdge Development: Programming Interfaces for more information on streams.

STREAM-HANDLE handle

Specifies the handle to a stream. If handle it is not a valid handle to a stream, the AVM generates a run-time error. Note that stream handles are not valid for the unnamed streams. See the chapter on alternate I/O sources in OpenEdge Development: Programming Interfaces for more information on streams and stream handles.

field

Represents the name of the field or variable you want to underline.

frame-phrase

Specifies the overall layout and processing properties of a frame. For more information on frame-phrase, see the Frame phrase reference entry.

Example

This procedure produces a report of Customer records, categorized by State. When the last Customer for a certain state has been displayed (determined by the LAST-OF function), the UNDERLINE statement underlines the State field.

r-under1.p

FOR EACH Customer NO-LOCK BREAK BY Customer.State WITH USE-TEXT:
  DISPLAY Customer.State Customer.CustNum Customer.Name.
  IF LAST-OF(Customer.State) THEN UNDERLINE Customer.State.
END.

Notes

See also

DEFINE STREAM statement, Frame phrase, Stream object handle