TIMER Object
Updated: Sep 24, 2004

The TIMER object invokes a system function to call a user-defined subroutine
after a specified time interval.

All properties and methods are read or write values.

PROPERTIES (Read/Write):
~~~~~~~~~~ ~~~~~~~~~~~~~
Enabled    .Enabled = 1 instructs system to call .OnTimer after .Interval.
           Also, HotBasic creates a TimeProc to handle this message from
           the system to the .OnTimer routine and assign the .User value.
           .Enabled = 0 cancels a previous .Enabled = 1 and frees
           system resources.

Interval   Interval in milliseconds.

Repeated   One-Shot (0) or Repeated (1). Default = 0

Resolution Resolution of timer in milliseconds (1 to ??). Default = 50
           Lower resolution values use more CPU time and resources.
           .Resolution = 1 uses more CPU time than .Resolution = 100

Tag        Timer identifier returned by system after .Enabled = 1.
           If .Tag = 0 before .Enabled = 1, then .Tag <> 0 confirms
           successful start of timer by system. 

User       Application.Handle returned by system when Timer expires.
           If .User = 0 before .Enabled = 1, then
           .User = Application.Handle indicates system called correct
           .OnTimer procedure. 


EVENTS     Description
~~~~~~     ~~~~~~~~~~~
OnTimer    Name of SUB or LABEL of subroutine containing a RETURN.


###########
hottimer.bas in the HotTrial tutorials shows a working code example.


Copyright 2003 James J Keene PhD
Original Publication: Oct 5, 2003
