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



parameters
A DicomFilmSessionParameters object that specifies the parameters of the Film Session to be created. If this is set to a null reference (Nothing in Visual Basic), then the request will be sent to the Print SCP without specifying any parameters (Attributes).
colorPrintManagement
If either the Basic Grayscale Print Management Meta SOP Class or the Basic Color Print Management Meta SOP Class (but not both) is supported on the Association, then this parameter will be ignored and the request will be to create an Instance of the Basic Film Session SOP Class of the Meta SOP Class supported. If both Meta SOP Classes are supported then: If colorPrintManagement is true, the request will be to create an Instance of the Basic Film Session SOP Class of the Basic Color Print Management Meta SOP Class; otherwise, the request will be to create an Instance of the Basic Film Session SOP Class of the Basic Grayscale Print Management Meta SOP Class.
parameters
A DicomFilmSessionParameters object that specifies the parameters of the Film Session to be created. If this is set to a null reference (Nothing in Visual Basic), then the request will be sent to the Print SCP without specifying any parameters (Attributes).
colorPrintManagement
If either the Basic Grayscale Print Management Meta SOP Class or the Basic Color Print Management Meta SOP Class (but not both) is supported on the Association, then this parameter will be ignored and the request will be to create an Instance of the Basic Film Session SOP Class of the Meta SOP Class supported. If both Meta SOP Classes are supported then: If colorPrintManagement is true, the request will be to create an Instance of the Basic Film Session SOP Class of the Basic Color Print Management Meta SOP Class; otherwise, the request will be to create an Instance of the Basic Film Session SOP Class of the Basic Grayscale Print Management Meta SOP Class.
Requests the Print SCP to create a Basic Film Session SOP Instance.

Syntax

Visual Basic (Declaration) 
Public Sub CreateFilmSession( _
   ByVal parameters As DicomFilmSessionParameters, _
   ByVal colorPrintManagement As Boolean _
) 
Visual Basic (Usage)Copy Code
Dim instance As DicomPrintScu
Dim parameters As DicomFilmSessionParameters
Dim colorPrintManagement As Boolean
 
instance.CreateFilmSession(parameters, colorPrintManagement)
C# 
public void CreateFilmSession( 
   DicomFilmSessionParameters parameters,
   bool colorPrintManagement
)
C++/CLI 
public:
void CreateFilmSession( 
   DicomFilmSessionParameters^ parameters,
   bool colorPrintManagement
) 

Parameters

parameters
A DicomFilmSessionParameters object that specifies the parameters of the Film Session to be created. If this is set to a null reference (Nothing in Visual Basic), then the request will be sent to the Print SCP without specifying any parameters (Attributes).
colorPrintManagement
If either the Basic Grayscale Print Management Meta SOP Class or the Basic Color Print Management Meta SOP Class (but not both) is supported on the Association, then this parameter will be ignored and the request will be to create an Instance of the Basic Film Session SOP Class of the Meta SOP Class supported. If both Meta SOP Classes are supported then: If colorPrintManagement is true, the request will be to create an Instance of the Basic Film Session SOP Class of the Basic Color Print Management Meta SOP Class; otherwise, the request will be to create an Instance of the Basic Film Session SOP Class of the Basic Grayscale Print Management Meta SOP Class.

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 Neither the Basic Grayscale Print Management Meta SOP Class nor the Basic Color Print Management Meta SOP Class is supported on the Association.

Once a Film Session is created, the method CreateFilmBox can then be used to create one or more Film Boxes in the new Film Session. Notice that only one Film Session can be handled on the Association at any time.

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.CreateFilmSession is successful, the Film Session was created successfully, with either a Success or Warning status code in the response of the Print SCP.

Having the Film Session created, the method GetFilmSessionInstanceUid can be used to obtain its SOP Instance UID. Also, the methods UpdateFilmSession, PrintFilmSession, and DeleteFilmSession can be used to update, print, and delete the Film Session, respectively.

The parameter parameters specifies the parameters to be used when creating the Film Session. In the passed object, if a string property is a null reference (Nothing in Visual Basic), then the corresponding Attribute will not be included in the request to the Print SCP. Similarly, if a numeric property is negative, the corresponding Attribute will not be included in the request. If parameters is set to a null reference, then the request will be sent without specifying any parameters.

All the rest of the basic Print Management methods will adopt the Meta SOP Class of the created Basic Film Session SOP Instance.

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