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

More documents

Recommendations

Info

AdfinX Real Time 1.0 Library - User's Guide Example A Visual Basic implementation of an object providing the IListEvents interface involves using a class module. This will look something like the following: Implements IListEvents Dim list as AdxRtList Set list = New AdxRtList list.ListAdvise Me 'This declares that the object implemented by the class module contains a list object…' '… which is created here. ' 'This associates the object with the list item it knows about, list. In other words, list ‘s events will be sent to the object containing it. ' list.StartUpdates RT_MODE_ONUPDATE 'Ask for updates for items registered by the list. ' 'The following event callback for the interface can be created by the Visual Basic editor. ' Sub IListEvents_OnUpdate(ByVal MyList as AdxRtxLibCtl.IAdxRtList, _ ItemName as String, UserTag as Long, ItemStatus as RT_ItemStatus) Dim MyArray as Variant MyArray = MyList.ListItems(RT_IRV_UPDATED, RT_ICV_USERTAG) 'The objects list (a property of the class module’s object) and MyList (received as a parameter to this function) are in fact the same. ' End Sub 2.4.1. ListAdvise ListAdvise(pListEvents) This method allows the user application to receive events for the AdxRtList object though an alternative interface. The event callback functions are methods of an object implementing the IListEvents interface. When the AdxRtList object’s StartUpdates method is called, the events will be delivered to the methods of the interface object. Arguments pListEvents A pointer to an object implementing the IListEvents interface. This object need not be unique for all AdxRtList objects. 2.4.2. ListUnadvise ListUnadvise() This method detaches the AdxRtList object from an object implementing the IListEvents interface. Arguments None. 28
AdfinX Real Time 1.0 Library - User's Guide 2.4.3. OnUpdate OnUpdate(MyList, ItemName, UserTag, ItemStatus) The OnUpdate event causes a call to this method of the object providing the IListEvents interface for the AdxRtList object. The two objects were linked through a call to the AdxRtList object’s ListAdvise method. Arguments MyList ItemName UserTag ItemStatus A pointer to the IAdxRtList interface of the AdxRtList object for which the event was delivered. The name of one of the items registered in the list object identified by MyList. The update event is associated with this item. This parameter should be treated as constant: it must not be changed by the application code. The user tag associated with the item, if one was supplied using the UserTag method. This Variant value should be treated as constant. The status of the item, a value from the RT_ItemStatus enumeration. 2.4.4. OnImage OnImage(MyList,DataStatus) The OnImage event causes a call to this method of the object providing the IListEvents interface for the AdxRtList object. The two objects were linked through a call to the AdxRtList object’s ListAdvise method. Arguments MyList DataStatus A pointer to the IAdxRtList interface of the AdxRtList object for which the event was delivered. The status of the registered items, a value from the RT_DataStatus enumeration. This will have the value RT_DS_FULL if data have been received from the source for all registered items, or RT_DS_PARTIAL if at least one of the items still has no associated data at the end of the time-out period. 2.4.5. OnTime OnTime(My List) The OnTime event causes a call to this method of the object providing the IListEvents interface for the AdxRtList object. The two objects were linked through a call to the AdxRtList object’s ListAdvise method. Arguments MyList A pointer to the IAdxRtList interface of the AdxRtList object for which the event was delivered. 29
Page 1 and 2: AdfinX Real Time 1.0 Library User's
Page 3 and 4: AdfinX Real Time 1.0 Library - User
Page 27: AdfinX Real Time 1.0 Library - User
Page 51: AdfinX Real Time 1.0 Library - User

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

Create successful ePaper yourself

Delete template?

Save as template?