←Select platform

StartEditing Method

Summary

Starts editing the given AnnObject.

Syntax

C++

public virtual void StartEditing( 
   AnnObject annObject, 
   bool group 
)

  
Public Overridable Sub StartEditing( _ 
   ByVal annObject As Leadtools.Windows.Annotations.AnnObject, _ 
   ByVal group As Boolean _ 
)

public: 
virtual void StartEditing(  
   Leadtools.Windows.Annotations.AnnObject^ annObject, 
   bool group 
)

Parameters

annObject
An existing AnnObject to edit.

group
true to group this annObject with the object(s) currently being edited if(any); false otherwise.

Remarks

This method is called by the AnnAutomation object in design user mode whenever an object is "selected" (by clicking it with the mouse usually). You can manually start the editing process of an object by calling this method.

If you have object(s) that are currently being edited in this AnnAutomation and you want to either create a new group or add an annObject to the group currently being edited, then pass true for group; otherwise pass false. Passing true when no objects are currently being edited will not create a new group and edits this object individually as normal. Passing false when objects are currently being edited will cause the current editing operation to be canceled and start a new one for annObject.

Example

This example will add a new rectangle object to the active automation of an automation manager. It will then "select" this object and make it ready for editing.

Silverlight C#

Silverlight VB

using Leadtools.Windows.Controls; 
using Leadtools.Windows.Annotations; 
using Leadtools.Demos; 
using Leadtools.Help; 
 
private void AnnAutomation_StartEditing(AnnAutomationManager manager) 
{ 
   // find the active automation 
   AnnAutomation automation = null; 
   for (int index = 0; index < manager.Automations.Count && automation == null; index++) 
   { 
      if (manager.Automations[index].Active) 
         automation = manager.Automations[index]; 
   } 
 
   if (automation != null) 
   { 
      // add a new rectangle object to this automation 
      AnnRectangleObject rectObj = new AnnRectangleObject(); 
      rectObj.Rect = new Rect(100, 100, 200, 200); 
      rectObj.Stroke = Colors.Blue; 
      rectObj.Fill = Colors.Yellow; 
      rectObj.StrokeThickness = 2.0; 
 
      // surround the changes to the automation by an undo 
      automation.BeginUndo(); 
 
      automation.Container.Children.Add(rectObj); 
 
      // "select" this rectangle and make it ready for editing 
      automation.StartEditing(rectObj, false); 
 
      automation.EndUndo(); 
   } 
}

Imports Leadtools.Windows.Controls 
Imports Leadtools.Windows.Annotations 
 
Private Sub AnnAutomation_StartEditing(ByVal manager As AnnAutomationManager) 
   ' find the active automation 
   Dim automation As AnnAutomation = Nothing 
   Dim index As Integer = 0 
   Do While index < manager.Automations.Count AndAlso automation Is Nothing 
      If manager.Automations(index).Active Then 
         automation = manager.Automations(index) 
      End If 
      index += 1 
   Loop 
 
   If Not automation Is Nothing Then 
      ' add a new rectangle object to this automation 
      Dim rectObj As AnnRectangleObject = New AnnRectangleObject() 
      rectObj.Rect = New Rect(100, 100, 200, 200) 
      rectObj.Stroke = Colors.Blue 
      rectObj.StrokeThickness = 2.0 
      rectObj.Fill = Colors.Yellow 
 
      ' surround the changes to the automation by an undo 
      automation.BeginUndo() 
 
      automation.Container.Children.Add(rectObj) 
 
      ' "select" this rectangle and make it ready for editing 
      automation.StartEditing(rectObj, False) 
 
      automation.EndUndo() 
   End If 
End Sub

using Leadtools.Windows.Controls; 
using Leadtools.Windows.Annotations; 
using Leadtools.Examples; 
using Leadtools.Silverlight.Demos; 
//using Leadtools.Help; 
 
private void AnnAutomation_StartEditing(AnnAutomationManager manager) 
{ 
   // find the active automation 
   AnnAutomation automation = null; 
   for (int index = 0; index < manager.Automations.Count && automation == null; index++) 
   { 
      if (manager.Automations[index].Active) 
         automation = manager.Automations[index]; 
   } 
 
   if (automation != null) 
   { 
      // add a new rectangle object to this automation 
      AnnRectangleObject rectObj = new AnnRectangleObject(); 
      rectObj.Rect = new Rect(100, 100, 200, 200); 
      rectObj.Stroke = Colors.Blue; 
      rectObj.Fill = Colors.Yellow; 
      rectObj.StrokeThickness = 2.0; 
 
      // surround the changes to the automation by an undo 
      automation.BeginUndo(); 
 
      automation.Container.Children.Add(rectObj); 
 
      // "select" this rectangle and make it ready for editing 
      automation.StartEditing(rectObj, false); 
 
      automation.EndUndo(); 
   } 
}

Imports Leadtools.Windows.Controls 
Imports Leadtools.Windows.Annotations 
Imports Leadtools.Silverlight.Demos 
'using Leadtools.Help; 
 
Private Sub AnnAutomation_StartEditing(ByVal manager As AnnAutomationManager) 
   ' find the active automation 
   Dim automation As AnnAutomation = Nothing 
   Dim index As Integer = 0 
   Do While index < manager.Automations.Count AndAlso automation Is Nothing 
      If manager.Automations(index).Active Then 
         automation = manager.Automations(index) 
      End If 
      index += 1 
   Loop 
 
   If Not automation Is Nothing Then 
      ' add a new rectangle object to this automation 
      Dim rectObj As AnnRectangleObject = New AnnRectangleObject() 
      rectObj.Rect = New Rect(100, 100, 200, 200) 
      rectObj.Stroke = Colors.Blue 
      rectObj.Fill = Colors.Yellow 
      rectObj.StrokeThickness = 2.0 
 
      ' surround the changes to the automation by an undo 
      automation.BeginUndo() 
 
      automation.Container.Children.Add(rectObj) 
 
      ' "select" this rectangle and make it ready for editing 
      automation.StartEditing(rectObj, False) 
 
      automation.EndUndo() 
   End If 
End Sub

Requirements

Target Platforms

Reference

AnnAutomation Class

AnnAutomation Members

Help Version 19.0.2017.10.27

Leadtools.Windows.Annotations Assembly

Introduction

Getting Started

Namespaces

Leadtools.Windows.Annotations Namespace

Assemblies