←Select platform

Run Event

Summary

Occurs when an AnnObject is being run.

Syntax

Java

Objective-C

WinRT C#

C++

public event EventHandler<AnnRunDesignerEventArgs> Run

Public Event Run As EventHandler(Of AnnRunDesignerEventArgs)

public event EventHandler<AnnRunDesignerEventArgs> Run

-(void) automation:(LTAnnAutomation*) automation  
       runWithArgs:(LTAnnRunDesignerEventArgs*) e;

public void addRunDesignerListener(AnnRunDesignerListener listener) 
public void removeRunDesignerListener(AnnRunDesignerListener listener)

add_Run(function(sender, e)) 
remove_Run(function(sender, e))

public:  
   event EventHandler<AnnRunDesignerEventArgs^>^ Run

Event Data

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.

Remarks

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.

Example

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.

using Leadtools.Annotations.Automation; 
using LeadtoolsExamples.Common; 
using Leadtools.Annotations.Core; 
using Leadtools.Codecs; 
using Leadtools.Controls; 
using Leadtools.Annotations.Rendering; 
using Leadtools.Annotations.WinForms; 
 
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); 
   } 
}

Requirements

Target Platforms

Reference

AnnAutomation Class

AnnAutomation Members

Help Version 19.0.2017.10.27

Leadtools.Annotations.Automation Assembly

Introduction

Getting Started

Namespaces

Leadtools.Annotations.Automation Namespace

Assemblies