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

BYEBYEBOX()

    This is not an earth-shaking function.  All it does is restore the
    area of the screen affected by one of the previously-mentioned box
    drawing functions.  However, it will save you numerous hours by
    freeing you from the drudgery of changing box coordinates.

    Syntax

    BYEBYEBOX(<screen>)

    Required Parameter

    <screen> is a character string (Summer '87) or five element array
    (Clipper 5) representing the screen information previously
    returned by the aforementioned box drawing functions.

    Return Value

    Nada

    Sample usage

    The general methodology for saving, changing, and then restoring a
    chunk of screen goes like so:

    buffer = SAVESCREEN(w, x, y, z)
    SHADOWBOX(w, x, y, z, 2)       
    RESTSCREEN(w, x, y, z)         

    You will often have to massage the box coordinates, and you can see
    that you would have to change them three times.  But with
    BYEBYEBOX(), you only need to change them once:

    buffer = SHADOWBOX(w, x, y, z, 2)
    INKEY(0)                         
    BYEBYEBOX(buffer)                

    Clipper 5.0 Notes

    BYEBYEBOX() is now a preprocessor function.  Therefore, you must put
    the following line at the top of any .PRG referring to BYEBYEBOX():

    #include "grump.ch"

    Also note that under Clipper 5.0, BYEBYEBOX() is expecting a five
    element array rather than a concatenated character string.  If you
    use GRUMP.CH, you will not have any problems.