Reuters AdfinX Real Time 1.0 Library User Guide (Doc. No. 4510529)
Reuters AdfinX Real Time 1.0 Library User Guide (Doc. No. 4510529)
Reuters AdfinX Real Time 1.0 Library User Guide (Doc. No. 4510529)
Create successful ePaper yourself
Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.
<strong>AdfinX</strong> <strong>Real</strong> <strong>Time</strong> <strong>1.0</strong> <strong>Library</strong> - <strong>User</strong>'s <strong>Guide</strong><br />
Error Handling<br />
An error exception may be thrown in the following cases:<br />
If the Source has not been set (i.e. the source is in the state RT_SOURCE_NOT_SET) an error<br />
exception is thrown.<br />
If either the ItemName or the FieldName has not been registered in the AdxRtList object (using<br />
RegisterItems), an exception will be thrown indicating the invalid argument.<br />
If the user tag is not an integer value and the FieldName indicates a valid field, an exception will<br />
be thrown indicating the invalid argument.<br />
If the DebugLevel general property is RT_DEBUG_NO, and either the ItemName or the<br />
FieldName is already known to be invalid, an exception will be thrown indicating the invalid<br />
argument.<br />
If the DebugLevel general property is RT_DEBUG_IMMEDIATE, the program waits for a callback to<br />
determine the validity of either ItemName or FieldName. If either is invalid, an exception will be<br />
thrown indicating the invalid argument. <strong>No</strong>te that this approach is inherently slow.<br />
Example<br />
Public list as AdxRtList<br />
Set list = New AdxRtList<br />
list.<strong>User</strong>Tag("RTR.L", "") = "Port:cld"<br />
'Associate the string value "Port:cld" with the item "RTR.L"<br />
of list‘s item list. When the OnUpdate event associated with<br />
this item is handled, this string value is passed as the <strong>User</strong>Tag<br />
parameter to the callback function. '<br />
list.<strong>User</strong>Tag("DEM=", "BID") = 100<br />
'Associate the integer value 100 with the item "DEM=" of list‘s<br />
item list. '<br />
2.1.9. ListFields<br />
ListFields(ItemName, RView, CView)<br />
This property supplies an item’s field information in a two dimensional array of Variant. The array<br />
can have up to four columns. The first column identifies the fields. Other, optional columns supply field<br />
data values, field status (see the RT_FieldStatus enumeration) and user tag (see the <strong>User</strong>Tag<br />
property) values.<br />
The RView and CView parameters control the contents of the array.<br />
Arguments<br />
ItemName<br />
RView<br />
CView<br />
The name of the required item as a string.<br />
One of the values from the RT_FieldRowView enumeration. This specifies<br />
that the array should contain a row for each field supplied by the item, or<br />
each registered field of the item, or only each updated field of the item<br />
(changed since the last update was handled).<br />
A combination of values from the RT_FieldColumnView enumeration. This<br />
specifies which of the three optional columns will be supplied: data, status<br />
and user tag. The enumeration values should be combined by adding them<br />
together.<br />
13
Change language