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

EXPBOX()

    EXPBOX() is similar to EXBOX(), except that it can be truly
    imploded using IMPBOX().  True implosion means that the underlying
    screen is restored piece by piece, which is quite a dazzling effect.
    (By contrast, SHRBOX() does not restore the underlying screen.)

    Summer '87 Syntax

    EXPBOX(<top>, <left>, <bottom>, <right>, [<type>, <speed>, <color>, ;
           <array>, <title>])

    Clipper 5.0 Syntax

    EXPBOX(<top>, <left>, <bottom>, <right>, [<type>, <speed>, <color>, ;
           <title>])

    Required Parameters

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

    Optional Parameters

    <type> is an integer 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

    The default is 1 (double line).

    <delay> is an integer numeric between 0 and 100, and is used to
    delay the box drawing effect.  The larger the delay, the longer the
    explosion will take.  Values between 2 and 100 are recommended, with
    2 being the fastest and 100 being the slowest.  The default is 20.

    <array> is the name of an array that will be created and serve to
    save the screen shots for implosion with IMPBOX(). If you do not
    pass this parameter, the array will not be created and you will thus
    be unable to implode this box.  (Note: this parameter applies to
    the Summer '87 version only.)

    <color> is a character string that will be used as the color in
    which to draw the box.  If you do not pass this parameter, the box
    will be drawn in the current color (so let's hope it is a good
    one -- none of that red on green stuff, please!).

    <title> is a character string to be centered across the top row of
    the box.

    Return Value

    Nothing

    Notes

    The best way to use EXPBOX() is with the <array> parameter. The
    function creates an array, and then takes several snapshots of the
    screen as the box is drawn.  Each screen snapshot is saved to an
    element of the array.  You would then call IMPBOX(), which steps
    backwards through this array to create the illusion of imploding the
    box by restoring each snapshot of the screen. (Hmmm... where have I
    seen this effect before?)

    Clipper 5.0 Notes

    - Passing the array name is no longer necessary because a window
      stack is automatically maintained by EXPBOX().  Each time that you
      call EXPBOX(), the affected region of the screen will be added to
      the window stack.  Whenever you call IMPBOX(), it will use LIFO
      (last in, first out) logic to restore the previous screen.

    Sample Usage

    ** Summer '87                               
    EXPBOX(5, 10, 19, 59, 2, 10, '', 'boxarray')
    INKEY(0)                                    
    IMPBOX(boxarray, 50)                        

    ** Clipper 5.0              
    EXPBOX(5, 10, 19, 59, 2, 10)
    INKEY(0)                    
    IMPBOX(50)