←Select platform

SetEncapsulatedDocument(DicomElement,bool,string,DicomEncapsulatedDocument,DicomCodeSequenceItem) Method

Summary

Inserts an encapsulated document and corresponding DICOM elements into a DICOM data set in a disk file.

Syntax

C#
VB
Java
WinRT C#
C++
Public Overloads Sub SetEncapsulatedDocument( _ 
   ByVal element As Leadtools.Dicom.DicomElement, _ 
   ByVal child As Boolean, _ 
   ByVal fileDocument As String, _ 
   ByVal encapsulatedDocument As Leadtools.Dicom.DicomEncapsulatedDocument, _ 
   ByVal conceptNameCodeSequence As Leadtools.Dicom.DicomCodeSequenceItem _ 
)  
public void setEncapsulatedDocument(DicomElement element, boolean child, String fileDocument, DicomEncapsulatedDocument encapsulatedDocument, DicomCodeSequenceItem conceptNameCodeSequence) 
 function Leadtools.Dicom.DicomDataSet.SetEncapsulatedDocument(DicomElement,Boolean,String,DicomEncapsulatedDocument,DicomCodeSequenceItem)(  
   element , 
   child , 
   fileDocument , 
   encapsulatedDocument , 
   conceptNameCodeSequence  
) 

Parameters

element
A DicomElement in the data set.

child
true to insert the encapsulated document as a child of element., false to insert the encapsulated document on the same level as element.

fileDocument
The name of the file that will be encapsulated.

encapsulatedDocument
The encapsulated document module attributes

conceptNameCodeSequence
The concept name code sequence attributes

Remarks

This feature is available in version 16 or higher.

The members of the DicomEncapsulatedDocument class and the DicomCodeSequenceItem class together represent the set of attributes contained in the "Encapsulated Document Module Attributes'. The Encapsulated Information Object Definition (IOD) describes one of the following file types that has been encapsulated within a DICOM information object:

  • PDF document
  • CDA document

For more information, refer to Part 3 of the DICOM standard.

The encapsulatedDocument class corresponds to the Encapsulated Document Module Attributes described in part 3 of the DICOM specification. To set the Concept Name Code Sequence element (0040,A043) pass a conceptNameCodeSequence object.

fileDocument is a file location of the document that will be encapsulated. This should be either a PDF or a CDA document, and the member of the DicomEncapsulatedDocument class should be set accordingly.

Example

C#
VB
Silverlight C#
Silverlight VB
using Leadtools; 
using Leadtools.Dicom; 
 
///  
void DicomDataSet_SetEncapsulatedDocumentExample(DicomElement element, bool child, DicomDataSet ds, string sFileDocumentIn) 
{ 
   DicomEncapsulatedDocument encapsulatedDocument = new DicomEncapsulatedDocument(); 
 
   encapsulatedDocument.Type = DicomEncapsulatedDocumentType.Pdf; 
   encapsulatedDocument.InstanceNumber = 123; 
   encapsulatedDocument.ContentDate = new DicomDateValue(2008, 12, 31); 
 
   encapsulatedDocument.ContentTime = new DicomTimeValue(12, 30, 00, 1); 
 
   encapsulatedDocument.AcquisitionDateTime = new DicomDateTimeValue(2008, 12, 31, 12, 30, 00, 01, -3); 
 
   encapsulatedDocument.BurnedInAnnotation = "YES"; 
   encapsulatedDocument.DocumentTitle = sFileDocumentIn; 
   encapsulatedDocument.VerificationFlag = "UNVERIFIED"; 
   encapsulatedDocument.HL7InstanceIdentifier = string.Empty; 
 
   // The 'pszMIMETypeOfEncapsulatedDocument' field is ignored when calling SetEncapsulatedDocument 
   // It is filled in when calling 'SetEncapsulatedDocument' 
   encapsulatedDocument.MimeTypeOfEncapsulatedDocument = "***** This is ignored when calling SetEncapsulatedDocument *****"; 
 
   string[] sListOfMimeTypes = new string[] { "image/jpeg", "application/pdf" }; 
   encapsulatedDocument.SetListOfMimeTypes(sListOfMimeTypes); 
   //encapsulatedDocument.nListOfMIMETypesCount               = 2; 
 
   DicomCodeSequenceItem conceptNameCodeSequence = new DicomCodeSequenceItem(); 
   conceptNameCodeSequence.CodingSchemeDesignator = "LN"; 
   conceptNameCodeSequence.CodeValue = "12345"; 
   conceptNameCodeSequence.CodeMeaning = "Sample Code Meaning"; 
 
   ds.SetEncapsulatedDocument(element, child, sFileDocumentIn, encapsulatedDocument, conceptNameCodeSequence); 
 
   // You can also use the overload that takes a stream 
   using (FileStream stream = new FileStream(sFileDocumentIn, FileMode.Open)) 
   { 
      ds.SetEncapsulatedDocument(element, child, stream, encapsulatedDocument, conceptNameCodeSequence); 
   } 
} 
Imports Leadtools 
Imports Leadtools.Dicom 
 
'''  
Private Sub DicomDataSet_SetEncapsulatedDocumentExample(ByVal element As DicomElement, ByVal child As Boolean, ByVal ds As DicomDataSet, 
                                                        ByVal sFileDocumentIn As String) 
   Dim encapsulatedDocument As DicomEncapsulatedDocument = New DicomEncapsulatedDocument() 
 
   encapsulatedDocument.Type = DicomEncapsulatedDocumentType.Pdf 
   encapsulatedDocument.InstanceNumber = 123 
   encapsulatedDocument.ContentDate = New DicomDateValue(2008, 12, 31) 
 
   encapsulatedDocument.ContentTime = New DicomTimeValue(12, 30, 0, 1) 
 
   encapsulatedDocument.AcquisitionDateTime = New DicomDateTimeValue(2008, 12, 31, 12, 30, 0, 1, -3) 
 
   encapsulatedDocument.BurnedInAnnotation = "YES" 
   encapsulatedDocument.DocumentTitle = sFileDocumentIn 
   encapsulatedDocument.VerificationFlag = "UNVERIFIED" 
   encapsulatedDocument.HL7InstanceIdentifier = String.Empty 
 
   ' The 'pszMIMETypeOfEncapsulatedDocument' field is ignored when calling SetEncapsulatedDocument 
   ' It is filled in when calling 'SetEncapsulatedDocument' 
   encapsulatedDocument.MimeTypeOfEncapsulatedDocument = "***** This is ignored when calling SetEncapsulatedDocument *****" 
 
   Dim sListOfMimeTypes As String() = New String() {"image/jpeg", "application/pdf"} 
   encapsulatedDocument.SetListOfMimeTypes(sListOfMimeTypes) 
   'encapsulatedDocument.nListOfMIMETypesCount               = 2; 
 
   Dim conceptNameCodeSequence As DicomCodeSequenceItem = New DicomCodeSequenceItem() 
   conceptNameCodeSequence.CodingSchemeDesignator = "LN" 
   conceptNameCodeSequence.CodeValue = "12345" 
   conceptNameCodeSequence.CodeMeaning = "Sample Code Meaning" 
 
   ds.SetEncapsulatedDocument(element, child, sFileDocumentIn, encapsulatedDocument, conceptNameCodeSequence) 
 
   ' You can also use the overload that takes a stream 
   Using stream As New FileStream(sFileDocumentIn, FileMode.Open) 
      ds.SetEncapsulatedDocument(element, child, stream, encapsulatedDocument, conceptNameCodeSequence) 
   End Using 
End Sub 
using Leadtools; 
using Leadtools.Dicom; 
using Leadtools.Examples; 
 
void DicomDataSet_SetEncapsulatedDocumentExample(DicomElement element, bool child, DicomDataSet ds, Stream sFileDocumentIn) 
{ 
   DicomEncapsulatedDocument encapsulatedDocument = new DicomEncapsulatedDocument(); 
 
   encapsulatedDocument.Type = DicomEncapsulatedDocumentType.Pdf; 
   encapsulatedDocument.InstanceNumber = 123; 
   encapsulatedDocument.ContentDate = new DicomDateValue(2008, 12, 31); 
 
   encapsulatedDocument.ContentTime = new DicomTimeValue(12, 30, 00, 1); 
 
   encapsulatedDocument.AcquisitionDateTime = new DicomDateTimeValue(2008, 12, 31, 12, 30, 00, 01, -3); 
 
   encapsulatedDocument.BurnedInAnnotation = "YES"; 
   encapsulatedDocument.DocumentTitle = "MyTest.pdf"; 
   encapsulatedDocument.VerificationFlag = "UNVERIFIED"; 
   encapsulatedDocument.HL7InstanceIdentifier = string.Empty; 
 
   // The 'pszMIMETypeOfEncapsulatedDocument' field is ignored when calling SetEncapsulatedDocument 
   // It is filled in when calling 'SetEncapsulatedDocument' 
   encapsulatedDocument.MimeTypeOfEncapsulatedDocument = "***** This is ignored when calling SetEncapsulatedDocument *****"; 
 
   string[] sListOfMimeTypes = new string[] { "image/jpeg", "application/pdf" }; 
   encapsulatedDocument.SetListOfMimeTypes(sListOfMimeTypes); 
 
   DicomCodeSequenceItem conceptNameCodeSequence = new DicomCodeSequenceItem(); 
   conceptNameCodeSequence.CodingSchemeDesignator = "LN"; 
   conceptNameCodeSequence.CodeValue = "12345"; 
   conceptNameCodeSequence.CodeMeaning = "Sample Code Meaning"; 
 
   ds.SetEncapsulatedDocument(element, child, sFileDocumentIn, encapsulatedDocument, conceptNameCodeSequence); 
} 
Imports Leadtools 
Imports Leadtools.Dicom 
 
Private Sub DicomDataSet_SetEncapsulatedDocumentExample(ByVal element As DicomElement, 
                                                        ByVal child As Boolean, 
                                                        ByVal ds As DicomDataSet, 
                                                        ByVal sFileDocumentIn As Stream) 
   Dim encapsulatedDocument As DicomEncapsulatedDocument = New DicomEncapsulatedDocument() 
 
   encapsulatedDocument.Type = DicomEncapsulatedDocumentType.Pdf 
   encapsulatedDocument.InstanceNumber = 123 
   encapsulatedDocument.ContentDate = New DicomDateValue(2008, 12, 31) 
 
   encapsulatedDocument.ContentTime = New DicomTimeValue(12, 30, 0, 1) 
 
   encapsulatedDocument.AcquisitionDateTime = New DicomDateTimeValue(2008, 12, 31, 12, 30, 0, 1, -3) 
 
   encapsulatedDocument.BurnedInAnnotation = "YES" 
   encapsulatedDocument.DocumentTitle = "MyTest.pdf" 
   encapsulatedDocument.VerificationFlag = "UNVERIFIED" 
   encapsulatedDocument.HL7InstanceIdentifier = String.Empty 
 
   ' The 'pszMIMETypeOfEncapsulatedDocument' field is ignored when calling SetEncapsulatedDocument 
   ' It is filled in when calling 'SetEncapsulatedDocument' 
   encapsulatedDocument.MimeTypeOfEncapsulatedDocument = "***** This is ignored when calling SetEncapsulatedDocument *****" 
 
   Dim sListOfMimeTypes As String() = New String() {"image/jpeg", "application/pdf"} 
   encapsulatedDocument.SetListOfMimeTypes(sListOfMimeTypes) 
 
   Dim conceptNameCodeSequence As DicomCodeSequenceItem = New DicomCodeSequenceItem() 
   conceptNameCodeSequence.CodingSchemeDesignator = "LN" 
   conceptNameCodeSequence.CodeValue = "12345" 
   conceptNameCodeSequence.CodeMeaning = "Sample Code Meaning" 
 
   ds.SetEncapsulatedDocument(element, child, sFileDocumentIn, encapsulatedDocument, conceptNameCodeSequence) 
End Sub 

Requirements

Target Platforms

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Dicom Assembly