Reuters AdfinX Real Time 1.0 Library User Guide (Doc. No. 4510529)

AdfinX Real Time 1.0 Library - User's Guide
2.3.3. OnTime
OnTime()
This event is generated regularly by a timer at a frequency determined by the "FRQ" attribute
parameter (see the Mode property) on behalf of the AdxRtList object which is receiving data
following a call to StartUpdates using the RT_MODE_ONTIME mode.
User code should provide a callback function to handle these events. In this function, the ListItems
method can be used to see which items have changed since the last OnTime event; for each of these,
ListFields method can be called to obtain the values of the updated fields.
Arguments
None
2.3.4. OnStatusChange
OnStatusChange(ListStatus, SourceStatus, RunMode)
This event is generated every time a change occurs that affects the status of the AdxRtList object as
a whole. Such events are:
The Source property is changed.
The RT_RunMode changes (through a call to the StartUpdates method).
The real time data streams are stopped (through external events) or closed (through a call to the
CloseAllLinks method).
The AdxRtList object goes from empty to non-empty.
User code should supply a callback function to handle these events within the program.
Arguments
ListStatus
SourceStatus
RunMode
The current status of the AdxRtList object. This is a value from the
RT_ListStatus enumeration.
The current status of the data source (identified by the Source property).
This is a value from the RT_SourceStatus enumeration.
The current update mode, usually changed through the StartUpdates
method. This is a value from the RT_RunMode enumeration.
2.4. ADXRTLIST ILISTEVENTS INTERFACE
A user application can use the IListEvents interface as an alternative to the standard event
(connection point) interface associated with an object of type AdxRtList. To use this alternative
interface, the user application must associate an object which implements the IListEvents interface
with the AdxRtList object or objects. This is done using the AdxRtList object’s ListAdvise
method. The association can be broken by calling the ListUnadvise method.
Once an association of this type has been established, the various events delivered for the
AdxRtList object will cause the corresponding methods of the IListEvents object to be called.
Using this interface allows methods to be dispatched using a vtable mechanism. This is a much faster
process than that of using the connection point mechanism, improving the user application’s
performance.
27