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

  WKILL()                                                    Window Function
 Purpose..: Remove a window from memory
-------------------------------------------------------------------------------
 Syntax...: wKill( <uWin> [, <bHow>] ) --> lSuccess

 Arguments: <uWin>  = the string identifier of the window
                      OR the reference to the window structure
                      returned as an array by wNew() or wArray().
                      There is no default.

            [<bHow>]= code block used as a closing method
                      to override that defined originally.
                      You can set the delay rate, the lower
                      the number the faster the closing.

            bHow Translate Directive as found in FW_BOX.CH
            ---------------------------------------------------------
            FW_BOX.CH         Description
            ---------------------------------------------------------
            B_IMPLODEDN( n )  Implode from the top down       delay n
            B_IMPLODEUP( n )  Implode from the bottom up      delay n
            B_IMPLODERT( n )  Implode from right to left      delay n
            B_IMPLODELT( n )  Implode from left to right      delay n
            B_VBLIND( n )     Use a vertical blind effect     delay n
            B_IMPLODE( n )    Implode the window to centre    delay n
            ---------------------------------------------------------
            B_EXPLODEDN( n )  Explode from the top down;      delay n
            B_EXPLODEUP( n )  Explode from the bottom;        delay n
            B_EXPLODERT( n )  Explode from right to left;     delay n
            B_EXPLODELT( n )  Explode from left to right;     delay n
            B_EXPLODE( n )    Explode from center;            delay n
            ---------------------------------------------------------

 Returns..: <L> lSuccess is TRUE if successful.

 Remark...: wKill() removes a window from memory. The window cannot be
            used again. Any attempt to use functions such as wOpen()
            or wClose() will fail.

            A window can be killed at any time. If it is open, wKill()
            will close it first. If not, it is removed from memory.

            The delay rate is not hardware-related. Rather it is a
            sliding scale to allow you to vary the delay in closing
            or opening. A rate of, say, 30, will be no faster
            on a '486 than it would be on a '286 machine.

 Source...: WKILL.PRG
-------------------------------------------------------------------------------
 Example..: wKill( "MyWin", B_VBLIND( 90 ) )

            The function call deletes the window, "MyWin", from memory,
            closing it with the vertical blind effect.

            As with all FreshWin window functions that alter the display,
            this function hides and redisplays automatically the mouse
            cursor if it is active.