LINE

This Command displays a line of text on a Viewport (if the Viewport itself is visible).

Parameters

TEXT

Text to be Displayed. This will be converted into upper case unless it is enclosed in quotes. Text containing embedded word separator characters (spaces, commas etc.) should also be enclosed in quotes.

Qualifiers

/ROW=<x-cor>

ROW is a synonym for Y_COR.

/STYLE=<style>

Overrides the default Text Style for the Viewport. The possible Style attributes are BLINK, BOLD, REVERSE and UNDERLINE and they may be specified using the following syntax:-

/STYLE=(BOLD,REVERSE,...)

\

Omitting the attributes will result in normal Text and the parentheses may be omitted if only a single attribute is desired.

/VIEWPORT=<id>

Specifies the Viewport within which the text is to be displayed. This defaults to the current Viewport (as defined by the previous VIEWPORT Command) if this Qualifier is absent or has no associated Value. The syntax of the Viewport ID is described in full for the VIEWPORT Command.

/Y_COR=<y-cor>

This specifies the desired vertical placement of the line of text. If this Qualifier is omitted, then the current Y Coordinate will be used. The Y-Coordinate should be specified in the units appropriate for the current Viewport Display Mode (See the MODE/VIEWPORT Command). Thus, for TEXT Viewport Mode the units are in Columns and may be specified as Integer or Floating Point Numbers, while for GRAPHICS Mode they are in Graphics Units and must be specified in Floating Point.

The specified Text will only be actually displayed on the terminal screen if the corresponding Viewport has been made visible (via a DISPLAY Command). Text within a TEXT Viewport will scroll off the top if the current line reaches the bottom of the Viewport. Qualifiers may be attached either to the Keyword or to the Character Text and thus the following is legal:-

LINE/STYLE=(BOLD,REVERSE) "Text String"/YCOR=10.0