DISPLAY Command
Displays a message to the user.
Syntax
DISPLAY messageText {+} {(VmvCode}
Syntax Elements
messageText The message text. This can include literal text and control sequences.
+ Suppresses the trailing carriage return.
Options
VmvMode Specifies which set of video codes to use (to simplify MultiValue migration).
Restrictions
Intended for use in TCL Macros and Procs only.
Using DISPLAY after a select deletes the active list.
Control Sequences
| Control Sequence | Effect |
|---|---|
| @(column{,row}) | Positions cursor at the specified screen coordinates. Both parameters must be integers greater than or equal to 0; if greater than the current maximum (set by the most recent execution of the TERM command), the cursor is placed in the right-most column or bottom row as appropriate. If row is omitted, the cursor remains on the current line. |
| @(code) | Generates an extended cursor addressing or video effects code. The
effects of these codes depends on the
MultiValue video mode,
selected with the V option (default, Reality). All extended cursor
addressing and video effects codes are negative integers. Refer to the DataBasic @ function for details of the codes available in Reality mode. The @ compatibility option lists codes for other modes. |
| @({count}n) | Generates count carriage returns. If count is omitted, only one carriage return is generated. |
| @({count}b) | Generates count bell characters. If count is omitted, only one bell is generated. |
| @(O{.}code) | Generates the character with the specified ASCII code. If code is preceded by a dot (.), it is interpreted as hexadecimal; otherwise it is interpreted as decimal. Valid values are from 0 to 254 decimal (x'00' to x'FE' hex). |
| `command` | Substitutes the result of executing command, which must be enclosed in grave accents (reverse single quotes). |
MultiValue Video Modes
The following Multivalue video modes are available:
| Value | $OPTIONS Vendor |
|---|---|
| 0 | Reality (default) |
| 1 | Pick, R83 |
| 2 | GA |
| 3 | PRIME Information |
| 4 | IN2 (Intertechnique) |
| 5 | MVBASE |
| 6 | MVENTERPRISE |
| 16 | Reality Ext |
| 17 | AP |
| 18 | PWR95 |
| 33 | D3 (v8.0) |
Refer to the DataBasic @ function for details of the codes available in Reality mode. The topic @ compatibility option lists codes for other modes.
Examples
DISPLAY The time is now `TIME`, your port/usr/account is `WHO`
Note
The TIME and WHO commands must be enclosed in grave accents (reverse single quotes).
Inserts the output from the TIME and WHO commands into the specified text.
display @(-1)@(-13)this is highlighted text@(-14)+
Clears the screen and highlights the specified text in reverse video.
See Also
COMMENT command, PROMPT command, TCL Macros.