LEADTOOLS Medical (Leadtools.Dicom assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.29
CreateOverlayBox Method
See Also 
Leadtools.Dicom Namespace > DicomPrintScu Class : CreateOverlayBox Method



overlay
A DicomDataSet object that contains the Overlay data for the Image Overlay Box to be created. The object is assumed to contain the Overlay Pixel Data Sequence (2040,0020). If this parameter is set to a null reference (Nothing in Visual Basic) or if the Sequence is not present, the method will fail.
parameters
A DicomOverlayBoxParameters object that specifies the parameters of the Image Overlay Box to be created. The method will fail if this is set to a null reference (Nothing in Visual Basic).
overlay
A DicomDataSet object that contains the Overlay data for the Image Overlay Box to be created. The object is assumed to contain the Overlay Pixel Data Sequence (2040,0020). If this parameter is set to a null reference (Nothing in Visual Basic) or if the Sequence is not present, the method will fail.
parameters
A DicomOverlayBoxParameters object that specifies the parameters of the Image Overlay Box to be created. The method will fail if this is set to a null reference (Nothing in Visual Basic).
Requests the Print SCP to create a Basic Print Image Overlay Box SOP Instance.

Syntax

Visual Basic (Declaration) 
Public Sub CreateOverlayBox( _
   ByVal overlay As DicomDataSet, _
   ByVal parameters As DicomOverlayBoxParameters _
) 
Visual Basic (Usage)Copy Code
Dim instance As DicomPrintScu
Dim overlay As DicomDataSet
Dim parameters As DicomOverlayBoxParameters
 
instance.CreateOverlayBox(overlay, parameters)
C# 
public void CreateOverlayBox( 
   DicomDataSet overlay,
   DicomOverlayBoxParameters parameters
)
C++/CLI 
public:
void CreateOverlayBox( 
   DicomDataSet^ overlay,
   DicomOverlayBoxParameters^ parameters
) 

Parameters

overlay
A DicomDataSet object that contains the Overlay data for the Image Overlay Box to be created. The object is assumed to contain the Overlay Pixel Data Sequence (2040,0020). If this parameter is set to a null reference (Nothing in Visual Basic) or if the Sequence is not present, the method will fail.
parameters
A DicomOverlayBoxParameters object that specifies the parameters of the Image Overlay Box to be created. The method will fail if this is set to a null reference (Nothing in Visual Basic).

Example

For an example, refer to DicomPrintScu.Associate.

Remarks

Two of the exceptions that can be thrown by this method are:
Exception Type Condition
DicomExceptionCode.PrintSCUFailureStatus The response of the Print SCP specifies a Failure status code; no Instance was created.
DicomExceptionCode.PrintSCUClassNotSupported The Basic Print Image Overlay Box SOP Class is not supported on the Association.

The method will not return until it receives the response of the Print SCP, or an error occurs. The method GetLastOperationStatus can be used to obtain the status code specified in the response of the Print SCP. If the method Leadtools.Dicom.DicomPrintScu.CreateOverlayBox is successful, the Image Overlay Box was created successfully, with either a Success or Warning status code in the response of the Print SCP.

The method can be used to create one or more Image Overlay Boxes. Having an Image Overlay Box created, the method GetOverlayBoxInstanceUid can be used to obtain its SOP Instance UID, which in turn can be used to reference the Image Overlay Box from Image Boxes. Refer to the method Leadtools.Dicom.DicomPrintScu.UpdateImageBox.

The methods can be used to update and delete Image Overlay Boxes, respectively.

The parameter parameters specifies the parameters to be used when creating the Image Overlay Box. The properties DicomOverlayBoxParameters.OverlayOriginRow and DicomOverlayBoxParameters.OverlayOriginColumn in the passed object will always be used to specify the Overlay Origin (6000,0050); these can be negative. If a string property, in the passed object, is a null reference (Nothing in Visual Basic), then the corresponding Attribute will not be included in the request to the Print SCP. Also, if the property DicomOverlayBoxParameters.MagnifyToNumberOfColumns is negative, the corresponding Attribute will not be included in the request.

Requirements

Target Platforms: Silverlight 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7, MAC OS/X (Intel Only)

See Also

Leadtools.Dicom requires a Medical toolkit server license and unlock key. For more information, refer to: Imaging Pro/Document/Medical Features