ActionUpdate Event

In This Topic

Description

fired when intermediate responses are received from the remote application

Syntax

Visual Basic
Public Event ActionUpdate( _ ByVal Connection As DicomConnection, _ ByVal Action As String, _ ByVal Tag As Variant, _ ByVal ResponseType As String, _ ByVal LastResponse As Long, _ ByVal LastDataSet As Long, _ ByVal LastImage As Long _ )

Visual Basic

Public Event ActionUpdate( _
   ByVal Connection As DicomConnection, _
   ByVal Action As String, _
   ByVal Tag As Variant, _
   ByVal ResponseType As String, _
   ByVal LastResponse As Long, _
   ByVal LastDataSet As Long, _
   ByVal LastImage As Long _
)

Parameters

Connection: Identifies the connection that has completed its operation
Action: The name of the action which has just completed
Tag: The value of the Tag property of the DicomConnection object at the time the action was initiated
ResponseType: One of the values “Response”, “DataSet” or “Image” indicating the nature of the intermediate result.
LastResponse: The index of the just added entry to the ReturnedResponses collection
LastDataSet: The index of the just added entry to the ReturnedDataSets collection
LastImage: The index of the just added entry to the ReturnedImages collection

Remarks

This Event will be generated when responses are received from the remote application. The situations where this occurs are:

In almost all operations, simple status returns can occur, and these are placed in the ReturnedResponses collection, and ActionUpdate fires with ResponseType of “Response”. Examples include status updates on the primary association during C-MOVE (the Move method) or responses to individual image storage during SendImages or SendModifiedImages.
During C-GET operations (the Get method), a response of type “Image” is generated as each image is received.
During C-FIND operations (the Find method) a response of type “DataSet” is generated as each result is received.

This event occurs asynchronously to prevent deadlocks, so by the time it fires, further data may have been added to the collection. That is why the LastXXX parameters are included, as by using them it is possible to ensure that each response is processed once and only once – you cannot assume that the last item in a collection is the one to be processed on any firing of this event.