Friday, March 3, 2006
From the Edge: Understanding Form Timer Properties
Section: Database Maintenance
Chapter: Running R:BASE Your Way!
Platform: R:BASE 7.5 and V-8 Turbo for Windows
Builds: R:BASE 7.5 (7.5.25.30303 or higher)
R:BASE V-8 Turbo (8.0.12.30303 or higher)
R:BASE 7.5 (Build: 7.5.25.30303 and higher ) and R:BASE
V-8 Turbo (Build: 8.0.12.30303 and higher) include a new
Timer property for a form to execute a custom code as an
event on demand. This property of a form can open many
possibilities to generate events based on defined time
intervals.
To access this property in Form Designer, click on the
Form Properties icon of Edit Controls Toolbar or [F11]
when no other control on the form is selected. Select
[Timer] tab to access Form Timer properties. (Figure 1)
When enabled, this new form property will control
whether the timer periodically generates events, such
as Custom EEPs. (Default: FALSE)
[ ] Timer Enabled: Use Timer Enabled to true (checked)
or disable (unchecked) the timer. If Timer Enabled
option is set to True, the timer responds normally.
If Timer Enabled option is set to False, the timer does
not generate Custom EEP events. The default is False.
Intervals (ms): Determines the amount of time, in
milliseconds, that passes before the timer property
of the form initiates another user defined event. Timer
Interval determines how frequently the defined Custom
EEP will execute. Each time the specified interval
passes, the defined Custom EEP event occurs.
Use Timer Interval to specify any cardinal value as
the interval between Custom EEP events. The default
value is 1000 (one second).
Note:
A 0 value is valid, however, the timer will not call
a Custom EEP event for a value of 0.
Use the following PROPERTY commands to manage Form
Timer Property in an EEP:
PROPERTY RBASE_FORM TIMERENABLED 'TRUE'
PROPERTY RBASE_FORM TIMERENABLED 'FALSE'
PROPERTY RBASE_FORM TIMERINTERVAL nnn
An important note about Form Timer property:
Any code used as Custom EEP for Form Timer event MUST
be fully tested and debugged prior to implementation.
Once executed as Custom EEP for Form Timer, you'll
have no way to stop any error(s) except by stopping
the RBG75 or RBG8 application process using Windows
Task Manager.
A PDF document od this article is available at:
From The Edge: http://www.razzak.com/fte
(Powered by R:WEB Suite 3.0)
To demonstrate the use of Form Timer Properties, a
sample application with source code is also available
at:
Sample Applications:
http://www.razzak.com/sampleapplications
(Powered by R:WEB Suite 3.0)
Database: FormTimr
Related Form: FormTimer
Command File: FormTimer.RMD
More sample applications will be available here as
we explore the possibilities of this new feature in
R:BASE 7.5 and V-8 Turbo for Windows.
Enjoy and make sure to have fun!
Very Best R:egards,
Razzak.
--- RBASE-L
================================================
TO POST A MESSAGE TO ALL MEMBERS:
Send a plain text email to [email protected]
(Don't use any of these words as your Subject:
INTRO, SUBSCRIBE, UNSUBSCRIBE, SEARCH,
REMOVE, SUSPEND, RESUME, DIGEST, RESEND, HELP)
================================================
TO SEE MESSAGE POSTING GUIDELINES:
Send a plain text email to [email protected]
In the message SUBJECT, put just one word: INTRO
================================================
TO UNSUBSCRIBE:
Send a plain text email to [email protected]
In the message SUBJECT, put just one word: UNSUBSCRIBE
================================================
TO SEARCH ARCHIVES:
Send a plain text email to [email protected]
In the message SUBJECT, put just one word: SEARCH-n
(where n is the number of days). In the message body,
place any
text to search for.
================================================
