DicomObjects Reference
DicomObjects Reference / DicomConnection Object / SendImages Method
One or more images, to be transmitted.
In This Topic
    SendImages Method
    In This Topic
    Description
    Send images over a DicomConnection
    Syntax
    Visual Basic
    Public Sub SendImages( _
       ByVal Images As Variant _
    ) 
    Parameters
    Images
    One or more images, to be transmitted.
    Remarks

    For automatically generated DicomConnection objects, this method is used in response to a C-GET or C-MOVE request, but it may also be used to send any images the client chooses over a “stand-alone” DicomConnection.
    The images sent by this method are sent either to the requesting application (C-GET) or to another (C-MOVE or stand-alone) as a series of C-STORE actions. 
    Unless Mode=doSync, this method returns immediately, and the images are sent asynchronously.  An ActionComplete event is generated once data transmission has been completed.

     In order to prevent a multi-tasking server having to wait whilst images are loaded before being sent, Data may be any one of a large number of data types, and if running asynchronously, DicomObjects will fetch the images then send then asynchronously on a separate thread without delaying other operations.  The data types allowed are:

    DicomImage object The single image is sent
    DicomImages collection All images are sent
    A String The file referenced by the string is read and sent
    An array of strings All are interpreted as filenames, which are read and sent
    An object supporting IStream The stream is read (as for ReadStream) and is sent
    An ADO, DAO or RDO field object The field is read (as for ReadField) and is sent
    For C-MOVE operations, no “pending” responses are generated by this method, and it is the client’s responsibility to make any that it wishes using the SendStatus method.  Therefore, if the client wishes to send a pending response after each image is transmitted, only single images should be transmitted by each call to this method.  Once all images have been sent, a final SendStatus call with a value of 0 should be made to terminate the association.

    The number of images remaining, failed, warning, and successful associated with the request are automatically updated by the method, and the Failures property maintains a list of refused images UIDs.  If all images are to be returned via a single call to SendImages, then no specific client action is required, as NumberRemaining is set automatically to the number of images in Data if previously 0.  If, however, the client wishes to return images via multiple calls to this method (e.g. to enable pending status messages), then NumberRemaining must be set correctly before the first image is returned.

    For a C-MOVE requests, or “stand-alone” DicomConnection objects, SetDestination must be called before this method.

    See also SendModifiedImages for when it is necessary to modify demographics “on the fly”.

    See Also