tcl.display Verb: Access/TCL

tcl.display

Command tcl.display Verb: Access/TCL
Applicable release versions: AP, AP 6.0
Category TCL (746)
Description outputs text on the terminal.
May be used in macros and PROCs to display messages to the screen.

If "message.text" is terminated by a plus sign (+), the trailing carriage return is suppressed.

"message.text" is either regular text, the following special characters, or any combination of them:

@(x{,y})
Positions cursor at the specified "x,y" coordinates where "x" indicates the row position and "y" indicates the column position.

@(-x)
Generates the corresponding video attributes. The values of 'x' are the exactly the same as the values of the Pick/BASIC "@ function".

@({x}N)
Generates 'x' carriage returns. If 'x' is omitted, only one carriage return is generated.

@({x}B)
Generates 'x' bells. If 'x' is omitted, only one bell is generated.

@(O[n|.x])
Generates one character whose decimal representation is 'n', or hexadecimal representation is 'x', preceded by a period. Valid values are from 0 to 254 decimal (x'00' to x'FE'). Valid on 6.1 and later only.

`command`
The result of the execution of "command", between back quotes, is substituted in place of "command".
Syntax display message.text {+}
Options
Example
display I am `who` !
  Displays:
    I am 0 joe pa !

display @(-1)@(-13)MAIN MENU@(-14)+
  Clears the screen, displays the highlighted text, and suppresses the trailing 
form feed.

display Sending DEL: @(O.7F)
  Send the the DEL character.
Purpose
Related macros
tcl.inputwait
tcl.type
tcl.prompt
tcl.cls
paragraph.introduction