[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 @...BOX
 Draw a box on the screen
------------------------------------------------------------------------------
 Syntax

     @ <nTop>, <nLeft>, <nBottom>, <nRight>
        BOX <cBoxString> [COLOR <cColorString>]

 Arguments

     <nTop>, <nLeft>, <nBottom>, <nRight> define the
     coordinates of the box.  @...BOX draws a box using row values from zero
     to MAXROW(), and column values from zero to MAXCOL().  If <nBottom> and
     <nRight> are larger than MAXROW() and MAXCOL(), the bottom-right corner
     is drawn off the screen.

     BOX <cBoxString> defines a string of eight border characters and a
     fill character.  If <cBoxString> is specified as a single character,
     that character draws the whole box.

     COLOR <cColorString> defines the display color of the drawn box.  If
     not specified, the box is drawn using the standard color setting of the
     current system color as defined by SETCOLOR().  Note that <cColorString>
     is a character expression containing the standard color setting.  If you
     want to specify a literal color setting, enclose it within quote marks.

 Description

     @...BOX draws a box on the screen using configurable border and fill
     characters.  @...BOX draws the box using <cBoxString> starting from the
     upper left-hand corner, proceeding clockwise and filling the screen
     region with the ninth character.  If the ninth character is not
     specified, the screen region within the box is not painted.  Existing
     text and color remain unchanged.

     After @...BOX executes, the cursor is located in the upper corner of the
     boxed region at <nTop> + 1 and  <nLeft> + 1.  ROW() and COL() are also
     updated to reflect the new cursor position.

 Examples

     .  These examples draw two boxes using box manifest constants
        defined in the supplied header file, Box.ch.  The first example draws
        a box using the specified characters for the border, but leaves all
        other areas of the screen intact.  The second example draws the same
        box filling the box region with space characters.

        #include "Box.ch"
        // Draw a box with a double-line top with a
        // single-line side
        @ 1, 1, 22, 79 BOX B_DOUBLE_SINGLE
        // Draw the same box filling the box region with
        // spaces
        @ 1, 1, 22, 79 BOX B_DOUBLE_SINGLE + SPACE(1)

 Files   Library is CLIPPER.LIB, header file is Box.ch.


See Also: @...CLEAR @...TO DISPBOX() SCROLL()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson