L_LTDIC_API L_INT L_DicomPrintSCUUpdateAnnotationBox(hPrintSCU, pszAnnotationBoxInstanceUID, uAnnotationPosition, pszTextString)
A handle to Dicom Print SCU.
SOP Instance UID of the Annotation Box.
Position of the Annotation Box in the parent Film Box.
Text string of the Annotation Box.
|SUCCESS||The function was successful.|
|< 1||An error occurred. Refer to Return Codes.|
When the Print SCP is requested to create a Film Box, and if an Annotation Display Format ID is specified, the Print SCP will also create one or more Annotation Boxes, based on the Annotation Display Format ID. This will happen only if the Basic Annotation Box SOP Class is supported on the Association. This function updates a particular Annotation Box. The Annotation Box specified (by the SOP Instance UID) must belong to the current (last created) Film Box.
The function will not return until it receives the response of the Print SCP, or an error occurs. L_DicomPrintSCUGetLastOperationStatus can be used to obtain the status code specified in the response of the Print SCP. When the return value of the function UpdateAnnotationBox is 0, then the Annotation Box was updated successfully, with either a Success or Warning status code in the response of the Print SCP.
Required DLLs and Libraries
Win32, x64, Linux.
For an example, refer to L_DicomPrintSCUUpdateImageBox.
Medical Web Viewer .NET
.NET, Java, Android, and iOS/macOS Assemblies
C API/C++ Class Libraries