Public Function CreateLayer( _
   ByVal graphicLayer As DicomGraphicLayer _
) As Integer

Visual Basic (Usage)	Copy Code
Dim instance As DicomDataSet Dim graphicLayer As DicomGraphicLayer Dim value As Integer   value = instance.CreateLayer(graphicLayer)

public int CreateLayer( 
   DicomGraphicLayer graphicLayer
)

public:
int CreateLayer( 
   DicomGraphicLayer^ graphicLayer
) 

Parameters

graphicLayer

A Graphic Layer attributes , which holds the attributes of the layer to be created.

Return Value

This example will initialize a new DICOM dataset, insert a new layer with one graphic object and one text object.

Visual Basic

Copy Code

Public Sub DicomLayerSample()    'Make sure to initialize the DICOM engine, this needs to be done only once    'In the whole application    DicomEngine.Startup()    Dim dicomDataset As DicomDataSet = New DicomDataSet()    Using (dicomDataset)       ' We can also initialize in here the "Grayscale Softcopy Presentation State" class       dicomDataset.Initialize(DicomClassType.Undefined, DicomDataSetInitializeType.ExplicitVRLittleEndian)       'We can remove individual layers by calling RemoveLayerByIndex and RemoveLayerByName       dicomDataset.RemoveAllLayers(True)       Dim graphicLayer As DicomGraphicLayer = New DicomGraphicLayer()       graphicLayer.LayerOrder = 1       graphicLayer.LayerDescription = "First Layer"       graphicLayer.LayerName = "LAYER0"       graphicLayer.Grayscale = 0       graphicLayer.RgbLayerColor = 255       dicomDataset.CreateLayer(graphicLayer)       Debug.Assert(dicomDataset.GetLayerIndex("LAYER0") = 0)       Dim graphicLayer1 As DicomGraphicLayer = dicomDataset.GetLayerInformation(0)       Debug.Assert(Not graphicLayer1 Is Nothing)       Debug.Assert(graphicLayer1.LayerOrder = 1)       graphicLayer.LayerName = "LAYER1"       dicomDataset.SetLayerInformation(0, graphicLayer)       Debug.Assert(dicomDataset.LayerCount = 1)       ' We can also call GetLayerElementByName to get the layer elemnt       Dim layer As DicomElement = dicomDataset.GetLayerElementByIndex(0)       Debug.Assert(Not layer Is Nothing)       dicomDataset.RemoveLayerGraphicObjects(layer)       Debug.Assert(dicomDataset.GetLayerGraphicObjectCount(layer) = 0)       dicomDataset.RemoveLayerTextObjects(layer)       Debug.Assert(dicomDataset.GetLayerTextObjectCount(layer) = 0)       dicomDataset.Save(LeadtoolsExamples.Common.ImagesPath.Path + "PresentationState.dic", DicomDataSetSaveFlags.None)    End Using    DicomEngine.Shutdown() End Sub

C#

Copy Code

public void DicomLayerSample()  {     //Make sure to initialize the DICOM engine, this needs to be done only once      //In the whole application     DicomEngine.Startup();     using (DicomDataSet dicomDataset = new DicomDataSet())     {        // We can also initialize in here the "Grayscale Softcopy Presentation State" class        dicomDataset.Initialize(DicomClassType.Undefined, DicomDataSetInitializeType.ExplicitVRLittleEndian);          //We can remove individual layers by calling RemoveLayerByIndex and RemoveLayerByName        dicomDataset.RemoveAllLayers(true);          DicomGraphicLayer graphicLayer = new DicomGraphicLayer();          graphicLayer.LayerOrder = 1;        graphicLayer.LayerDescription = "First Layer";        graphicLayer.LayerName = "LAYER0";        graphicLayer.Grayscale = 0;        graphicLayer.RgbLayerColor = 255;          dicomDataset.CreateLayer(graphicLayer);          Debug.Assert(dicomDataset.GetLayerIndex("LAYER0") == 0);          DicomGraphicLayer graphicLayer1 = dicomDataset.GetLayerInformation(0);        Debug.Assert(graphicLayer1 != null);        Debug.Assert(graphicLayer1.LayerOrder == 1);          graphicLayer.LayerName = "LAYER1";        dicomDataset.SetLayerInformation(0, graphicLayer);          Debug.Assert(dicomDataset.LayerCount == 1);          //  We can also call GetLayerElementByName to get the layer elemnt        DicomElement layer = dicomDataset.GetLayerElementByIndex(0);        Debug.Assert(layer != null);          dicomDataset.RemoveLayerGraphicObjects(layer);        Debug.Assert(dicomDataset.GetLayerGraphicObjectCount(layer) == 0);          dicomDataset.RemoveLayerTextObjects(layer);        Debug.Assert(dicomDataset.GetLayerTextObjectCount(layer) == 0);          dicomDataset.Save(LeadtoolsExamples.Common.ImagesPath.Path + "PresentationState.dic", DicomDataSetSaveFlags.None);     }     DicomEngine.Shutdown();  }

This method will fail and throw a DicomExceptionCode.Parameter exception if a layer with the same name as the new layer already exists in the Data Set.

Target Platforms: Microsoft .NET Framework 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family

Reference