Using Non Automated Annotations in Run Mode

Using Non-Automated Annotations in Run Mode

Take the following steps to create and run a program that implements non-automated annotations. You will create a Note annotation, set the user mode, and activate the annotation by left-clicking the annotation.

1. Start Visual Studio .NET.

2. Choose File->New->Project… from the menu.

3. In the New Project dialog box, choose either "Visual C# Projects" or "VB Projects" in the Projects Type List, and choose "Windows Forms Application" in the Templates List.

4. Type the project name as "Using Non-Automated Annotations in Run Mode" in the Name field, and then click OK. If desired, type a new location for your project or select a directory using the Browse button, and then click OK.

5. In the "Solution Explorer" window, right-click the "References" folder, and select "Add Reference…" from the context menu. In the "Add Reference" dialog box, select the ".NET" tab and browse to the "<LEADTOOLS_INSTALLDIR>\Bin\DotNet4\Win32" folder and select the following DLLs:

   • Leadtools.dll
   • Leadtools.Annotations.Core.dll
   • Leadtools.Annotations.Rendering.WinForms.dll
   • Leadtools.Codecs.dll
   • Leadtools.Codecs.Cmp.dll
   • Leadtools.WinForms.dll

   Click Add and then click OK to add the above DLLs to the application.

6. Make sure Form1 is in design view. Go to the toolbox (View->Toolbox) and drag and drop an instance of the ImageViewer on the form. If you do not have the ImageViewer in your toolbox, choose Tools->Choose Toolbox Items from the main menu. Click Browse and then select the Leadtools.WinForms.DLL from the "<LEADTOOLS_INSTALLDIR>\Bin\DotNet4\Win32" folder. Next, click Open and then click OK.

7. Go to the toolbox (View->Toolbox) and drag and drop 2 Radio Button controls onto the form and set their properties as follows:

1. Switch to Form1 code view (right-click Form1 in the Solution Explorer and then select View Code). Add the following lines at the beginning of the file:

   VB

   Imports Leadtools 
   Imports Leadtools.Annotations.Core 
   Imports Leadtools.Annotations.Rendering 
   Imports Leadtools.Codecs 
   Imports Leadtools.WinForms 
                     
        

   C#

   using Leadtools; 
   using Leadtools.Annotations.Core; 
   using Leadtools.Annotations.Rendering; 
   using Leadtools.Codecs; 
   using Leadtools.WinForms; 
                     
        

2. Declare the following private enumeration:

   VB

   ' user mode 
   Private Enum UserModeEnum 
      RunMode 
      DesignMode 
   End Enum 
                     
        

   C#

   // user mode 
   private enum UserModeEnum 
   { 
      RunMode, 
      DesignMode 
   } 
                     
        

3. Declare the following private variables:

   VB

   ' Annotation container object 
   Private annContainerObj As AnnContainer 
   ' Annotation Rendering Engine 
   Private renderingEngine As AnnWinFormsRenderingEngine 
   ' Current user mode 
   Private currentUserMode As UserModeEnum 
                     
        

   C#

   // Annotation container object 
   private AnnContainer annContainerObj; 
   // Annotation Rendering Engine 
   private AnnWinFormsRenderingEngine renderingEngine; 
   // Current user mode 
   private UserModeEnum currentUserMode; 
                     
        

4. Add an event handler to the Form1 Load event and code it as follows:

   VB

   Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load 
      ' initialize a new RasterCodecs 
      Dim codecs As New RasterCodecs() 
      ' load the main image into our viewer 
      RasterImageViewer1.Image = codecs.Load("C:\Users\Public\Documents\LEADTOOLS Images\Sample1.cmp") 
      RasterImageViewer1.Zoom(ControlSizeMode.Fit, RasterImageViewer1.ScaleFactor, RasterImageViewer1.DefaultZoomOrigin) 
                        
      ' set the User Mode to design mode  
      currentUserMode = UserModeEnum.DesignMode 
                        
      If (Not IsNothing(RasterImageViewer1.Image)) Then 
         ' initialize the AnnContainer object and associate it with rasterImageViewer1 image 
         annContainerObj = New AnnContainer 
                    
         ' create an Annotation Note Object and add it to the container 
         annContainerObj.Children.Add(CreateAnnNoteObject(New LeadRectD(10, 10, 500, 500))) 
         ' initialize the Rendering Engine 
         renderingEngine = New AnnWinFormsRenderingEngine() 
      End If 
   End Sub    
                     
        

   C#

   private void Form1_Load(object sender, System.EventArgs e) 
   { 
      // initialize a new RasterCodecs 
      RasterCodecs codecs = new RasterCodecs(); 
      // load the main image into our viewer  
      rasterImageViewer1.Image = codecs.Load(@"C:\Users\Public\Documents\LEADTOOLS Images\Sample1.cmp"); 
      rasterImageViewer1.Zoom(ControlSizeMode.Fit, rasterImageViewer1.ScaleFactor, rasterImageViewer1.DefaultZoomOrigin); 
                        
      // set the User Mode to Design Mode 
      currentUserMode = UserModeEnum.DesignMode; 
                        
      if(rasterImageViewer1.Image != null) 
      { 
         // initialize the AnnContainer object and associate it with the rasterImageViewer1 image 
         annContainerObj = new AnnContainer(); 
         // create an Annotation Note Object and add it to the container 
         annContainerObj.Children.Add(CreateAnnNoteObject(new LeadRectD(10, 10, 500, 500))); 
         // initialize the Rendering Engine 
         renderingEngine = new AnnWinFormsRenderingEngine(); 
      } 
   } 
                     
        

5. Add an event handler to the radioButton1 CheckedChanged event and code it as follows:

   VB

   Private Sub RadioButton1_CheckedChanged(ByVal sender As System.Object, ByVal e As System.EventArgs) _ 
   Handles RadioButton1.CheckedChanged 
      UserModeChanged(sender) 
   End Sub    
                     
        

   C#

   private void radioButton1_CheckedChanged(object sender, System.EventArgs e) 
   { 
      UserModeChanged(sender); 
   } 
                     
        

6. Add an event handler to the radioButton2 CheckedChanged event and code it as follows:

   VB

   Private Sub RadioButton2_CheckedChanged(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles RadioButton2.CheckedChanged 
      UserModeChanged(sender) 
   End Sub    
                     
        

   C#

   private void radioButton2_CheckedChanged(object sender, System.EventArgs e) 
   { 
      UserModeChanged(sender); 
   }                
                     
        

7. Add an event handler to the rasterImageViewer1 MouseDown event and code it as follows:

   VB

   Private Sub RasterImageViewer1_MouseDown(ByVal sender As Object, ByVal e As System.Windows.Forms.MouseEventArgs) Handles RasterImageViewer1.MouseDown 
      If (IsNothing(RasterImageViewer1.Image)) Then 
         Return 
      End If 
      If (currentUserMode = UserModeEnum.RunMode) Then 
         Dim obj As AnnObject = HitTest(e.X, e.Y) 
         If (Not IsNothing(obj)) Then 
            Dim annNoteObj As AnnNoteObject = obj 
            If (Not IsNothing(annNoteObj)) Then 
               HandleHyperLink(annNoteObj) 
            End If 
         End If 
      End If 
   End Sub    
                     
        

   C#

   private void rasterImageViewer1_MouseDown(object sender, System.Windows.Forms.MouseEventArgs e) 
   { 
      if(rasterImageViewer1.Image == null) 
         return; 
      if(currentUserMode == UserModeEnum.RunMode) 
      { 
         AnnObject obj = HitTest(e.X, e.Y); 
         if (obj != null) 
         { 
            AnnNoteObject annNoteObj = obj as AnnNoteObject; 
            if(annNoteObj != null) 
               HandleHyperLink(annNoteObj); 
         } 
      } 
   } 
                     
        

8. Add an event handler to the rasterImageViewer1 PostImagePaint event and code it as follows:

   VB

   Private Sub RasterImageViewer1_PostImagePaint(ByVal sender As Object, ByVal e As System.Windows.Forms.PaintEventArgs) Handles RasterImageViewer1.PostImagePaint 
      If (Not IsNothing(annContainerObj)) Then 
         renderingEngine.Attach(annContainerObj, e.Graphics) 
         renderingEngine.Render(LeadRectD.Empty, true) 
         renderingEngine.Detach() 
      End If 
   End Sub    
                     
        

   C#

   private void rasterImageViewer1_PostImagePaint(object sender, System.Windows.Forms.PaintEventArgs e) 
   { 
      if(annContainerObj != null) 
      { 
         renderingEngine.Attach(annContainerObj, e.Graphics); 
         renderingEngine.Render(LeadRectD.Empty, true); 
         renderingEngine.Detach(); 
      } 
   }  
                     
        

9. Add the following function code to class Form1:

   VB

   Private Sub UserModeChanged(ByVal sender As Object) 
      If (sender Is radioButton1) Then 
         currentUserMode = UserModeEnum.DesignMode 
      Else 
         currentUserMode = UserModeEnum.RunMode 
      End If 
   End Sub 
   Private Function CreateAnnNoteObject(ByVal boundingRect As LeadRectD) As AnnObject 
      Dim annNoteObj As AnnNoteObject = New AnnNoteObject 
      annNoteObj.Text = "This is my Text" 
      annNoteObj.Font = New AnnFont("Arial", 14) 
      annNoteObj.Hyperlink = "Notepad.exe" 
      annNoteObj.Rect = boundingRect 
      Return annNoteObj 
   End Function 
   Private Function HitTest(ByVal x As Single, ByVal y As Single) As AnnObject 
      Dim obj As AnnObject = Nothing 
      If (Not IsNothing(RasterImageViewer1.Image)) Then 
         Dim testPoint As LeadPointD = New LeadPointD(x, y) 
         Dim objects As Array = annContainerObj.HitTestPoint(testPoint) 
         If objects.Length > 0 Then 
            obj = objects(0) 
         End If 
      End If 
                        
      Return obj 
   End Function 
                        
   Private Sub HandleHyperLink(ByVal obj As AnnObject) 
      If (Not IsNothing(obj.Hyperlink)) Then 
         Try 
            System.Diagnostics.Process.Start(obj.Hyperlink) 
         Catch ex As Exception 
            MessageBox.Show(ex.Message, "Error", MessageBoxButtons.OK, MessageBoxIcon.Exclamation) 
         End Try 
      End If 
   End Sub 
                     
        

   C#

   private void UserModeChanged(object sender) 
   { 
      currentUserMode = (sender == radioButton1)?UserModeEnum.DesignMode: UserModeEnum.RunMode; 
   } 
   private AnnObject CreateAnnNoteObject(LeadRectD boundingRect) 
   { 
      AnnNoteObject annNoteObj = new AnnNoteObject(); 
      annNoteObj.Text = "This is my Text"; 
      annNoteObj.Font = new AnnFont("Arial", 14); 
      annNoteObj.Hyperlink = "Notepad.exe"; 
      annNoteObj.Rect = boundingRect; 
      return annNoteObj; 
   } 
   private AnnObject HitTest(float x, float y) 
   { 
      AnnObject obj = null; 
      if (rasterImageViewer1.Image != null) 
      { 
         LeadPointD testPoint = new LeadPointD(x, y); 
         AnnObject[] objects = annContainerObj.HitTestPoint(testPoint); 
         if (objects.Length > 0) 
            obj = objects[0]; 
      } 
      return obj; 
   } 
   private void HandleHyperLink(AnnObject obj) 
   { 
      if(obj.Hyperlink != string.Empty) 
      { 
         try 
         { 
            System.Diagnostics.Process.Start(obj.Hyperlink); 
         } 
         catch(Exception ex) 
         { 
            MessageBox.Show(ex.Message, "Error", MessageBoxButtons.OK, MessageBoxIcon.Exclamation); 
         } 
      } 
   } 
                     
        

10. Build and run the program to test it. Click the Note annotation. Because the User Mode is Design Mode, the Note becomes selected and can be resized or moved. Double-clicking the Note puts the text in Edit View. Select the "Run Mode" radio button. Click the Note Annotation object. The specified hyperlink opens.