Working with Automated Annotation

Take the following steps to create and run a program that implements Automated Annotations:

Start Visual Studio .NET.
Choose File->New->Project… from the menu.
In the New Project dialog box, choose either "Visual C# Projects" or "Visual Basic Projects" in the Projects Type List, and choose "Windows Application " in the Templates List.
Type the project name as "Working With Automated Annotations" in the Project Name field, and then choose OK. If desired, type a new location for your project or select a directory using the Browse button, and then choose OK .
In the "Solution Explorer" window, right-click on 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\DotNet\Win32 " folder and select the following DLLs:
- Leadtools.dll
- Leadtools.Annotations.dll
- Leadtools.Codecs.dll
- Leadtools.Codecs.Cmp.dll
- Leadtools.WinForms.dll
Click the Select button and then press the OK button to add the above DLLs to the application. Make sure Form1 is in design view. Go to the toolbox (View->Toolbox) and Drag and drop an instance of RasterImageViewer to the form. If you do not have RasterImageViewer in your toolbox, select Tools->Add Remove Toolbox Items from the menu. Click Browse and then select Leadtools.WinForms.DLL from the "C:\LEADTOOLS 17.5\Bin\DotNet\Win32" folder and then click Open and then click OK.

Go to the toolbox (View->Toolbox) and Drag and drop 2 instances of RadioButton control to the bottom of the form, and set the following properties for them:

Text	Name	Checked
Design Mode	radioButton1	True
Run Mode	radioButton2	False

Switch to Form1 code view (right-click Form1 in the solution explorer then select View Code ) and add the following lines at the beginning of the file:

[Visual Basic]

             
            Imports Leadtools
            Imports Leadtools.Annotations
            Imports Leadtools.Codecs
            Imports Leadtools.WinForms

[C#]

             
            using Leadtools;
            using Leadtools.Annotations;
            using Leadtools.Codecs;
            using Leadtools.WinForms;

Declare the following private variable:

[Visual Basic]

             
            ' Automation Manager used in managing the automation mode.
            Private annAutomationManager As AnnAutomationManager

[C#]

             
            // Automation Manager used in managing the automation mode.
            private AnnAutomationManager annAutomationManager;

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

[Visual Basic]

             
            Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load
               ' intitialize a new RasterCodecs object
               Dim codecs As New RasterCodecs()
               ' load the main image into our viewer
               rasterImageViewer1.Image = codecs.Load("C:\Users\Public\Documents\LEADTOOLS Images\Sample1.cmp")
               
               If (Not IsNothing(RasterImageViewer1.Image)) Then
                  ' create and setup the automation manager
                  annAutomationManager = New AnnAutomationManager
                  
                  ' Instruct the manager to create the default (all) automation objects.
                  annAutomationManager.CreateDefaultObjects()
                  
                  ' create the toolbar and add it to the form
                  annAutomationManager.CreateToolBar()
                  Controls.Add(annAutomationManager.ToolBar)
                  
                  ' setup the automation (will create the container as well)
                  Dim automation As AnnAutomation = New AnnAutomation(annAutomationManager, RasterImageViewer1)
                  
                  ' setup this automation as the active one
                  automation.Active = True
               End If
            End Sub

[C#]

             
            private void Form1_Load(object sender, System.EventArgs e)
            {
               // intitialize a new RasterCodecs object
               RasterCodecs codecs = new RasterCodecs();
               // load the main image into our viewer
               rasterImageViewer1.Image = codecs.Load(@"C:\Users\Public\Documents\LEADTOOLS Images\Sample1.cmp");
               
               if(rasterImageViewer1.Image != null)
               {
                  // create and setup the automation manager
                  annAutomationManager = new AnnAutomationManager();
                  
                  // Instruct the manager to create the default (all) automation objects.
                  annAutomationManager.CreateDefaultObjects();
                  
                  // create the toolbar and add it to the form
                  annAutomationManager.CreateToolBar();
                  Controls.Add(annAutomationManager.ToolBar);
                  
                  // setup the automation (will create the container as well)
                  AnnAutomation automation = new AnnAutomation(annAutomationManager, rasterImageViewer1);
                  
                  // add an event handler for changes to the current designer
                  automation.CurrentDesignerChanged += new EventHandler(automation_CurrentDesignerChanged);
                  
                  // setup this automation as the active one
                  automation.Active = true;
               }
            }

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

[Visual Basic]

             
            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);
            }

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

[Visual Basic]

             
            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);
            }

Add the following function code to class Form1:

[Visual Basic]

             
            Private Sub UserModeChanged(ByVal sender As Object)
               If (Not IsNothing(annAutomationManager)) Then
                  If (sender Is radioButton1) Then
                     annAutomationManager.UserMode = AnnUserMode.Design
                  Else
                     annAutomationManager.UserMode = AnnUserMode.Run
                  End If
               End If
            End Sub

[C#]

             
            private void UserModeChanged(object sender)
            {
               annAutomationManager.UserMode = (sender == radioButton1)?AnnUserMode.Design: AnnUserMode.Run;
            }

Add the following function code to class Form1:

[Visual Basic]

            ' if the current designer is a button run designer, add a handler for Run
            Private Sub automation_CurrentDesignerChanged(ByVal sender As Object, ByVal e As EventArgs)
               Dim automation As AnnAutomation = DirectCast(sender, AnnAutomation)
               If (TypeOf (automation.CurrentDesigner) Is AnnButtonRunDesigner) Then
                  Dim buttonRunDesigner As AnnButtonRunDesigner = DirectCast(automation.CurrentDesigner, AnnButtonRunDesigner)
                  AddHandler buttonRunDesigner.Run, AddressOf buttonRunDesigner_Run
               End If
            End Sub
            Private Sub buttonRunDesigner_Run(ByVal sender As Object, ByVal e As AnnRunDesignerEventArgs)
               If (e.OperationStatus = AnnDesignerOperationStatus.End) Then
                  Dim btn As AnnButtonObject = DirectCast(e.Object, AnnButtonObject)
                  MessageBox.Show(String.Format("Button with text = {0} was clicked!", btn.Text))
               End If
            End Sub

[C#]

            // if the current designer is a button run designer, add a handler for Run
            private void automation_CurrentDesignerChanged(object sender, EventArgs e)
            {
               AnnAutomation automation = sender as AnnAutomation;
               AnnButtonRunDesigner buttonRunDesigner = automation.CurrentDesigner as AnnButtonRunDesigner;
               if(buttonRunDesigner != null)
                  buttonRunDesigner.Run += new EventHandler<AnnRunDesignerEventArgs>(buttonRunDesigner_Run);
            }
            private void buttonRunDesigner_Run(object sender, AnnRunDesignerEventArgs e)
            {
               if(e.OperationStatus == AnnDesignerOperationStatus.End)
               {
                  AnnButtonObject btn = e.Object as AnnButtonObject;
                  MessageBox.Show(string.Format("Button with text = {0} was clicked!", btn.Text)); 
               }
            }

Build, and Run the program to test it. You can now select objects from the toolbar, draw objects on top of the image, select the objects and move/change them. Right-click on any object to show its properties, etc.
Create an audio annotation. Right-click on the annotation and set the file to any .wav file available on your system. Create a button annotation. Right-click on the annotation and change any of the button properties you wish. Select Run Mode Radio button. As you move the cursor over the audio annotation and the button annotation, the cursor changes to a hand. Click on the audio annotation to hear the .wav file. Click on the button annotation to call the program listed in the Hyperlink field.