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

KillTimer()
Remove a timer for a window
------------------------------------------------------------------------------

Syntax
KillTimer( <hWnd>, <hTimer> )   -->   lSuccess

Arguments
<hWnd> is the handle to the window to be sent timer messages
(events).

<hTimer> is a either a handle to a timer (returned by the
SetTimer() function) or a non-zero integer specifying the
timer number.  Usually the first is specified as 1 (one), the
next 2 (two), etc.

Returns
If successful, a logical TRUE (.T.) is returned.  Otherwise,
FALSE (.F.) is returned.

Description
This function can be used to stop a timer started by the
SetTimer() function.

Example
SetTimer( hWnd, 1, 10000 )         // every 10 seconds

// main event loop:
do while .t.
     do while ( ev := ChkEvent() ) == EVENT_NONE
     enddo
     do case
     case ev == EVENT_TIMER
          //  .
          //  .
          //  .
          KillTimer( hWnd, 1 )     // stop the timer
     // case ev ==  . . .
     endcase
enddo