Navigation:  Reference > Form Objects >

TRtnTimer

Print this Topic Previous pageReturn to chapter overviewNext page

 

This is a non-visual object.  It won't appear on your form at runtime, however, it can call a routine in your program at a semi-regular interval.  If you want to execute an event only once a day at a specific time your should use the TAlarmClock instead of this object.

 

The icon for this object is on the Additional page.

 

PALETTE ICON & EXAMPLE

 

 

PROPERTIES

The following are the properties that apply to this object.  Some are defined in Common Properties and are linked to their appropriate page.

 

Behavior

 

Enabled

 

Misc

 

Name

Tag

 

Other

 

SecondsBtwnCalls

The value here determines the number of seconds between calls to the event routine.

Unless your routines very fast it is recommended that you set this to a minimum of 10.

 

COMMENTS

NOTE:  You should have only one TRtnTimer per form.  Also, if you have timers on other forms that are executing at the same time the calls they are making will "stack up" until they are executed.  This means if you're running a routine that takes a long time you could have calls to that routine, or others, waiting until it's done and returns control to the form before they are called.  Be careful how you use this. The user may never regain control of the form if you call the routine too often (the SecondsBtwnCalls property value is too small).

 

EVENTS

This object has a single event that is called if you have checked the Enabled property.  This event looks to your program for a special label.  It is made up of the object Name, a period (.) and the Event name (Call).  The full event name would be ObjectName.Call:.  You would not return a value from the program, just a simple RET is all that is required.  So, if the timer fires and if the event label exists, the routine is called, you return from the routine, and the user has control again.

 

 

 


Page url: http://www.cassoftware.com/tas/manual/trtntimer.htm