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 

Use The UNDERLINE statement to highlight fields or to underline accumulated values that you calculated using functions other than the automatic aggregate functions supplied with ABL.

When determining the position within a DOWN frame, the DOWN statement and the UP statement count the line used by an underline.

Even if the layout of a DOWN frame takes multiple screen lines, the underline takes just one line on the screen.

For a 1 DOWN frame or single frame, the UNDERLINE does not appear. Instead, the AVM clears the frame.

See also 

DEFINE STREAM statement, Frame phrase, Stream object handle