Run Event

The event handler receives an argument of type AnnRunDesignerEventArgs containing data related to this event. The following AnnRunDesignerEventArgs properties provide information specific to this event.

Property	Description
Cancel	Gets or sets a value indicating whether the run operation should be canceled.
Object	Gets the AnnObject that is entering run mode.
OperationStatus	Gets the status of the run operation.

When an object is being run, the automation object will hook the object run designer's AnnRunDesigner.Run to this event. Therefore, instead of hooking and unhooking to the various designers run events, you can simply subscribe to this event once.

This example will show how to track when an object is run.

Start with the AnnAutomationManager example, remove all the code inside the example function (search for the // TODO: add example code here comment) and insert the following code:

Draw a couple of objects and then click the example button. Now you switch into run mode and whenever you click on an object, a message will show.

• C#
• Visual Basic
• WinRT C#
• WinRT JavaScript
• Silverlight C#
• Silverlight VB

Copy Code  

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

[TestMethod]
public void AnnAutomation_Run()
{
   // Switch to run mode
   _automation.Manager.UserMode = AnnUserMode.Run;
   // Hook to the automation's Run event
   _automation.Run += _automation_Run;
}

void _automation_Run(object sender, AnnRunDesignerEventArgs e)
{
   if (e.OperationStatus == AnnDesignerOperationStatus.Start)
   {
      // Get the object being run
      Debug.WriteLine("In run mode, you clicked an object of id " + e.Object.Id);
   }
}

using Leadtools.Annotations.Automation;
using Leadtools.Controls;
using Leadtools.Converters;
using Leadtools.Annotations.Core;
using Leadtools.Codecs;

[TestMethod]
public void AnnAutomation_Run()
{
   // Switch to run mode
   _automation.Manager.UserMode = AnnUserMode.Run;
   // Hook to the automation's Run event
   _automation.Run += _automation_Run;
}

void _automation_Run(object sender, AnnRunDesignerEventArgs e)
{
   if (e.OperationStatus == AnnDesignerOperationStatus.Start)
   {
      // Get the object being run
      Debug.WriteLine("In run mode, you clicked an object of id " + e.Object.Id);
   }
}

Target Platforms

Reference

AnnAutomation Class
AnnAutomation Members