@...BOX

From Recital Documentation Wiki
Revision as of 14:22, 3 June 2009 by Yvonnemilne (Talk | contribs)

Jump to: navigation, search

Class

Screen Forms


Purpose

Draw a box using the specified coordinates


Syntax

@<expN1>,<expN2>,<expN3>,<expN4> BOX [<expC>]


See Also

@...CLEAR, @...FILL, @...GET, @...MENU, @...PROMPT, @...SAY, @...SCROLL, @...TO, CLEAR, CLEAR SCREEN, COL(), RESTSCREEN(), RESTORE SCREEN, ROW(), SAVE SCREEN, SAVESCREEN(), Terminal Definition Files


Description

This command can be used to draw a box on the screen, or on a user-defined window. <expN1> and <expN2> define the row and column coordinates of the upper left-hand corner of the box, and <expN3> and <expN4> define the row and column coordinates of the lower right hand corner of the box. If <expN1> and <expN3> contain the same value, a horizontal line will be drawn. If <expN2> and <expN4> are the same value, a vertical line will be drawn.

The optional argument <expC> defines the characters to fill the box. Up to nine characters may be used and if fewer than nine characters are used, a partial box will be drawn. The first character of the <expC> fills the top left corner of the box. The second character of the <expC> fills the top row of the box. The third character fills the top right corner of the box. The fourth character fills the right side of the box. The fifth character fills the bottom right corner of the box. The sixth character fills the bottom row of the box. The seventh character fills the bottom left corner of the box. The eighth character fills the left side of the box, and the ninth character fills the remaining center of the box.

@...BOX expects the <expC> to contain line drawing characters if the following line is in the terminal definition file:

221=\001 # enable 8-bit PC characters.

To disable entry 221, prefix it with a '!'.


Example

@0,0,10,10 box "123456789"
 
12222222223
89999999994
89999999994
89999999994
89999999994
89999999994
89999999994
89999999994
89999999994
89999999994
76666666665


Products

Recital Mirage Server, Recital Terminal Developer