Point.OnTimed (statement)

Syntax Point.OnTimed time_period
Description To poll the points value periodically. A new value will be sent to the application every time_period seconds. The application should call GetNext to retrieve the next value.
Comments Unlike the OnChange method, you may miss values of the point if it changes in between your polls. Use the OnChange method to receive the point whenever it changes. OnTimed is useful if the point is rapidly changing and you are only interested in its value in a periodic manner. Only one of the OnChange , OnAlarm , OnTimed or OnAlarmAck requests may be active at a time.
Parameter Description
time_period Integer. Time period in seconds to read the point.
Example
Sub main()
??????Dim MyPoint as new Point??????' Declare the point object
??????MyPoint.Id = "TANK_LEVEL"????' Set the point Id
??????MyPoint.OnTimed 60??????????????????' Request value every minute
Top :
????????MyPoint.GetNext??????????????????????' Read the value
????????Trace MyPoint.Value??????????????' Put it out to the trace buffer
????????goto top????????????????????????????????????' Repeat forever
end sub
See Also Point.GetNext (method); Point.OnChange (method); Point.Cancel (method).