Click above to get retro games delivered to your door ever month!

EXBOX()

    Exploding boxes add enormous appeal to your color applications.

    Syntax

    EXBOX(<top>, <left>, <bottom>, <right>, <type>, <delay>
          [,<fill>, <shadow>, <title>, <crossbar>])

    Required Parameters

    <top>, <left>, <bottom>, <right> are integers representing the box
    coordinates.

    <type> is an integer numeric between 1 and 6, and represents the
    type of box desired. The choices are:

    Box Number            Box Type

        1                  Double
        2                  Single
        3            Double Horiz., Single Vert.
        4            Single Horiz., Double Vert.
        5                 Thick Line
        6                 No border

    <delay> is an integer numeric between 0 and 100, and is used to
    delay the 'explosion'.  The larger the delay, the longer the box
    drawing operation will take.  I recommend using values between 1 and
    20, but you should experiment with this to discover what setting
    works best with your particular hardware.

    Optional Parameters

    <fill> is a character string to use as the fill character.  If the
    length of the character string passed is greater than one, only the
    leftmost character will be used.  If this parameter is not specified,
    the fill character will be the customary space (CHR(32)).

    <shadow> is a logical value.  If True (.T.), a transparent drop
    shadow will be drawn with the box.  If False (.F.), no shadow will
    be drawn.  The default is no shadow.

    <title> is a character string to be used as the box title.  It will
    be centered on the top row of the box.

    <crossbar> is a variable of any type.  It affects the display of the
    box title. If you pass this parameter, the title will be centered on
    the row below the top row of the box, and a horizontal line (or
    crossbar) will be drawn on the row beneath that.  If you do not pass
    this parameter, the title will be centered and framed on the top row
    of the box.

    Return Value

    EXBOX() returns a character string, which contains the coordinates
    of the box, followed by the contents of that area of the screen
    prior to the box being drawn.  For example, an exploding box drawn
    at coordinates 0, 0, 24, 79 would return the string containing
    CHR(0) + CHR(0) + CHR(24) + CHR(79), followed by the contents of
    SAVESCREEN(0,0,24,79). This character string can be used by
    ByeByeBox() to redisplay that portion of the screen.

    Note that under Clipper 5, this function returns a five element
    array rather than a concatenated character string.  The structure
    of this array is { <top>, <left>, <bottom>, <right>, <contents>}.
    This makes performance brisker when using BYEBYEBOX().

    Sample usage

    buffer = EXBOX(11,28,13,51,2,1,'',.T.,'ID ENTRY')
    @12,30 SAY 'Enter your ID:' GET mID              
    READ                                             
    ByeByeBox(buffer)                                

    When using a monochrome monitor, the exploding box will be drawn in
    the normal fashion with no spectacular effects.  This is a good
    reason to trade in your monochrome monitor for VGA!