TIMER Object
Updated: May 31, 2006

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.
           .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       Any user-supplied value which can be used in the .OnTimer routine.


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-2006 James J Keene PhD
Original Publication: Oct 5, 2003
