Leadtools.MedicalViewer Requires Medical Imaging license | Send comments on this topic. | Back to Introduction - All Topics | Help Version 16.5.9.25
SaveRegion(String,Int32,Int32,MedicalViewerFileOperation) Method
See Also  Example
Leadtools.MedicalViewer Namespace > MedicalViewerCell Class > SaveRegion Method : SaveRegion(String,Int32,Int32,MedicalViewerFileOperation) Method



fileName
A string that contains the path to the file to which to save the region.
subCellIndex
Index of the sub-cell that contains the image which is having its regions saved.
startPage
The page number of a multi-page file, which can contain more than one region. When saving a file, any value greater than the total number of pages will cause the saved region to be appended to the end of the file.
operation
An enumerated MedicalViewerFileOperation value that indicates the operation to be taken on the file when saving a region.
Saves cell regions to a file.

Syntax

Visual Basic (Declaration) 
Public Overloads Sub SaveRegion( _
   ByVal fileName As String, _
   ByVal subCellIndex As Integer, _
   ByVal startPage As Integer, _
   ByVal operation As MedicalViewerFileOperation _
)
Visual Basic (Usage)Copy Code
Dim instance As MedicalViewerCell
Dim fileName As String
Dim subCellIndex As Integer
Dim startPage As Integer
Dim operation As MedicalViewerFileOperation
 
instance.SaveRegion(fileName, subCellIndex, startPage, operation)
C# 
public void SaveRegion( 
   string fileName,
   int subCellIndex,
   int startPage,
   MedicalViewerFileOperation operation
)
C++/CLI 
public:
void SaveRegion( 
   String^ fileName,
   int subCellIndex,
   int startPage,
   MedicalViewerFileOperation operation
)

Parameters

fileName
A string that contains the path to the file to which to save the region.
subCellIndex
Index of the sub-cell that contains the image which is having its regions saved.
startPage
The page number of a multi-page file, which can contain more than one region. When saving a file, any value greater than the total number of pages will cause the saved region to be appended to the end of the file.
operation
An enumerated MedicalViewerFileOperation value that indicates the operation to be taken on the file when saving a region.

Example

Visual BasicCopy Code
Private Class MedicalViewerForm7 : Inherits Form
   Private _medicalViewer As MedicalViewer
   Private Sub MedicalViewerForm_SizeChanged(ByVal sender As Object, ByVal e As EventArgs)
      _medicalViewer.Size = New Size(Me.ClientRectangle.Right, Me.ClientRectangle.Bottom)
   End Sub

   Public Sub New()
      RasterCodecs.Startup()
      Dim _codecs As RasterCodecs = New RasterCodecs()
      Dim _image As RasterImage

      AddHandler SizeChanged, AddressOf MedicalViewerForm_SizeChanged

      ' Create the medical viewer and adjust the size and the location.
      _medicalViewer = New MedicalViewer(1, 2)
      _medicalViewer.Location = New Point(0, 0)
      _medicalViewer.Size = New Size(Me.ClientRectangle.Right, Me.ClientRectangle.Bottom)

      ' add some action that will be used to change the properties of the images inside the control.
      _medicalViewer.AddAction(MedicalViewerActionType.WindowLevel)
      _medicalViewer.AddAction(MedicalViewerActionType.Alpha)
      _medicalViewer.AddAction(MedicalViewerActionType.Offset)

      ' assign the added actions to a mouse button, meaning that when the user click and drag the mouse button, the associted action will be activated.
      _medicalViewer.SetAction(MedicalViewerActionType.WindowLevel, MedicalViewerMouseButtons.Left, MedicalViewerActionFlags.Active Or MedicalViewerActionFlags.RealTime)
      _medicalViewer.SetAction(MedicalViewerActionType.Alpha, MedicalViewerMouseButtons.Middle, MedicalViewerActionFlags.Active Or MedicalViewerActionFlags.RealTime)
      _medicalViewer.SetAction(MedicalViewerActionType.Offset, MedicalViewerMouseButtons.Right, MedicalViewerActionFlags.Active Or MedicalViewerActionFlags.RealTime)

      ' Load an image and then add it to the control.
      _image = _codecs.Load(LeadtoolsExamples.Common.ImagesPath.Path + "xa.dcm")
      _medicalViewer.Cells.Add(New MedicalViewerCell(_image, True, 1, 1))

      ' adjust some properties to the cell and add some tags.
      _medicalViewer.Cells(0).SetTag(2, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.UserData, "EX. ID 230-36-5448")
      _medicalViewer.Cells(0).SetTag(4, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.Frame)
      _medicalViewer.Cells(0).SetTag(6, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.Scale)
      _medicalViewer.Cells(0).SetTag(2, MedicalViewerTagAlignment.BottomLeft, MedicalViewerTagType.WindowLevelData)
      _medicalViewer.Cells(0).SetTag(1, MedicalViewerTagAlignment.BottomLeft, MedicalViewerTagType.FieldOfView)


      ' Load another image and then add it to the control.
      _image = _codecs.Load(LeadtoolsExamples.Common.ImagesPath.Path + "mr.dcm")
      _medicalViewer.Cells.Add(New MedicalViewerCell(_image, True, 2, 2))

      ' adjust some properties to the cell and add some tags.
      _medicalViewer.Cells(1).SetTag(2, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.UserData, "EX. ID 230-36-5448")
      _medicalViewer.Cells(1).SetTag(4, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.Frame)
      _medicalViewer.Cells(1).SetTag(6, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.Scale)
      _medicalViewer.Cells(1).SetTag(2, MedicalViewerTagAlignment.BottomLeft, MedicalViewerTagType.WindowLevelData)
      _medicalViewer.Cells(1).SetTag(1, MedicalViewerTagAlignment.BottomLeft, MedicalViewerTagType.FieldOfView)


      RasterCodecs.Shutdown()
      Controls.Add(_medicalViewer)
   End Sub
   Public ReadOnly Property Viewer() As MedicalViewer
      Get
         Return _medicalViewer
      End Get
   End Property
End Class
Private Function GetMedicalControl7() As MedicalViewerForm7
   Return New MedicalViewerForm7()
End Function

' This example will create a bitmap region on the first frame of the first image and save it.

Public Sub MedicalViewerSaveRegionExample()
   Dim myForm As MedicalViewerForm7 = GetMedicalControl7()
   Dim medicalViewer As MedicalViewer = myForm.Viewer

   Dim width As Integer = medicalViewer.Cells(0).Image.Width
   Dim height As Integer = medicalViewer.Cells(0).Image.Height
   Dim centerX As Integer = (width / 2)
   Dim centerY As Integer = (height / 2)

   Dim region As Region = New Region(New Rectangle(centerX - width / 4, centerY - height / 4, centerX + width / 4, centerY + height / 4))

   medicalViewer.Cells(0).Image.AddGdiPlusRegionToRegion(Nothing, region, RasterRegionCombineMode.Set)
   medicalViewer.Cells(0).SaveRegion(LeadtoolsExamples.Common.ImagesPath.Path + "Test.rgn")

   myForm.ShowDialog()
End Sub
C#Copy Code
class MedicalViewerForm7 : Form 
{ 
    private MedicalViewer _medicalViewer; 
    void MedicalViewerForm_SizeChanged(object sender, EventArgs e) 
    { 
        _medicalViewer.Size = new Size(this.ClientRectangle.Right, this.ClientRectangle.Bottom); 
    } 
 
    public MedicalViewerForm7() 
    { 
        RasterCodecs.Startup(); 
        RasterCodecs _codecs = new RasterCodecs(); 
        RasterImage _image; 
 
        this.SizeChanged += new EventHandler(MedicalViewerForm_SizeChanged); 
 
        // Create the medical viewer and adjust the size and the location. 
        _medicalViewer = new MedicalViewer(1, 2); 
        _medicalViewer.Location = new Point(0, 0); 
        _medicalViewer.Size = new Size(this.ClientRectangle.Right, this.ClientRectangle.Bottom); 
 
        // add some action that will be used to change the properties of the images inside the control. 
        _medicalViewer.AddAction(MedicalViewerActionType.WindowLevel); 
        _medicalViewer.AddAction(MedicalViewerActionType.Alpha); 
        _medicalViewer.AddAction(MedicalViewerActionType.Offset); 
 
        // assign the added actions to a mouse button, meaning that when the user click and drag the mouse button, the associted action will be activated. 
        _medicalViewer.SetAction(MedicalViewerActionType.WindowLevel, MedicalViewerMouseButtons.Left, MedicalViewerActionFlags.Active | MedicalViewerActionFlags.RealTime); 
        _medicalViewer.SetAction(MedicalViewerActionType.Alpha, MedicalViewerMouseButtons.Middle, MedicalViewerActionFlags.Active | MedicalViewerActionFlags.RealTime); 
        _medicalViewer.SetAction(MedicalViewerActionType.Offset, MedicalViewerMouseButtons.Right, MedicalViewerActionFlags.Active | MedicalViewerActionFlags.RealTime); 
 
        // Load an image and then add it to the control. 
        _image = _codecs.Load(LeadtoolsExamples.Common.ImagesPath.Path + "xa.dcm"); 
        _medicalViewer.Cells.Add(new MedicalViewerCell(_image, true, 1, 1)); 
 
        // adjust some properties to the cell and add some tags. 
        _medicalViewer.Cells[0].SetTag(2, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.UserData, "EX. ID 230-36-5448"); 
        _medicalViewer.Cells[0].SetTag(4, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.Frame); 
        _medicalViewer.Cells[0].SetTag(6, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.Scale); 
        _medicalViewer.Cells[0].SetTag(2, MedicalViewerTagAlignment.BottomLeft, MedicalViewerTagType.WindowLevelData); 
        _medicalViewer.Cells[0].SetTag(1, MedicalViewerTagAlignment.BottomLeft, MedicalViewerTagType.FieldOfView); 
 
 
        // Load another image and then add it to the control. 
        _image = _codecs.Load(LeadtoolsExamples.Common.ImagesPath.Path + "mr.dcm"); 
        _medicalViewer.Cells.Add(new MedicalViewerCell(_image, true, 2, 2)); 
 
        // adjust some properties to the cell and add some tags. 
        _medicalViewer.Cells[1].SetTag(2, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.UserData, "EX. ID 230-36-5448"); 
        _medicalViewer.Cells[1].SetTag(4, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.Frame); 
        _medicalViewer.Cells[1].SetTag(6, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.Scale); 
        _medicalViewer.Cells[1].SetTag(2, MedicalViewerTagAlignment.BottomLeft, MedicalViewerTagType.WindowLevelData); 
        _medicalViewer.Cells[1].SetTag(1, MedicalViewerTagAlignment.BottomLeft, MedicalViewerTagType.FieldOfView); 
 
 
        RasterCodecs.Shutdown(); 
        Controls.Add(_medicalViewer); 
    } 
    public MedicalViewer Viewer 
    { 
        get { return _medicalViewer; } 
    } 
} 
MedicalViewerForm7 GetMedicalControl7() 
{ 
    return new MedicalViewerForm7(); 
} 
 
// This example will create a bitmap region on the first frame of the first image and save it. 
 
public void MedicalViewerSaveRegionExample() 
{ 
    MedicalViewerForm7 myForm = GetMedicalControl7(); 
    MedicalViewer medicalViewer = myForm.Viewer; 
 
    int width = medicalViewer.Cells[0].Image.Width; 
    int height = medicalViewer.Cells[0].Image.Height; 
    int centerX = (width / 2); 
    int centerY = (height / 2); 
 
    Region region = new Region(new Rectangle(centerX - width / 4, centerY - height / 4, centerX + width / 4, centerY + height / 4)); 
 
    medicalViewer.Cells[0].Image.AddGdiPlusRegionToRegion(null, region, RasterRegionCombineMode.Set); 
    medicalViewer.Cells[0].SaveRegion(LeadtoolsExamples.Common.ImagesPath.Path + "Test.rgn"); 
 
    myForm.ShowDialog(); 
}

Remarks

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

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