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

AdfinX Real Time 1.0 Library - User's Guide
4.2. ADXRTCHAIN METHODS
4.2.1. RequestChain
RequestChain()
This method fetches the data for the chain specified by the Source and ItemName parameters. This
action occurs asynchronously; the arrival of chain data, or an indication of a request error, causes the
OnUpdate event to occur.
Arguments
None
Example
Dim chain as AdxRtChain
Set chain = New AdxRtChain
chain.Source = "IDN"
chain.ItemName = ".FCHI"
chain.Mode = "IGNE:YES"
chain.RequestChain
'Set the chain item’s source.'
'Set the chain item’s name.'
'Remove empty entries.'
'Ask for the chain data.'
4.3. ADXRTCHAIN EVENTS
4.3.1. OnUpdate
OnUpdate(DataStatus)
This callback handles updates to the requested data. If the Update When Completed attribute is in
effect (see the "UWC" keyword of the Mode property), this will occur only once all chain data have been
retrieved, or some request error occurs. Otherwise, the event may be called a number of times before
all data have arrived.
If the Live attribute is active (see the "LIVE" keyword of the Mode property), updates may continue to
arrive following the completion of the chain’s data, as the source sends changes to the chain’s
contents.
Arguments
DataStatus
The status of the data retrieved by the request. This is a value taken from the
RT_DataStatus enumeration.
4.3.2. OnStatusChange
OnStatusChange(SourceStatus)
This callback is called every time a change occurs to the status of the data source specified by the
Source property while there is an outstanding RequestChain request.
39