LEADTOOLS Annotations (Leadtools.Annotations assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.29
StartEditing Method
See Also 
Leadtools.Annotations Namespace > AnnAutomation Class : StartEditing Method



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

The StartEditing Method is available in LEADTOOLS Document and Medical Imaging toolkits.

annObject
An existing AnnObject to edit.
group
true to group this annObject with the object(s) currently being edited if(any); false otherwise.
Starts editing the given AnnObject.

Syntax

Visual Basic (Declaration) 
Public Overridable Sub StartEditing( _
   ByVal annObject As AnnObject, _
   ByVal group As Boolean _
) 
Visual Basic (Usage)Copy Code
Dim instance As AnnAutomation
Dim annObject As AnnObject
Dim group As Boolean
 
instance.StartEditing(annObject, group)
C# 
public virtual void StartEditing( 
   AnnObject annObject,
   bool group
)
C++/CLI 
public:
virtual void StartEditing( 
   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.

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.

Visual BasicCopy Code
Public 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.Bounds = New AnnRectangle(100, 100, 200, 200, AnnUnit.Pixel)
      rectObj.Pen = New AnnPen(Color.Blue, New AnnLength(2, AnnUnit.Pixel))
      rectObj.Brush = New AnnSolidBrush(Color.Yellow)

      ' surround the changes to the automation by an undo
      automation.BeginUndo()

      automation.Container.Objects.Add(rectObj)

      ' "select" this rectangle and make it ready for editing
      automation.StartEditing(rectObj, False)

      automation.EndUndo()
   End If
End Sub
C#Copy Code
public 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.Bounds = new AnnRectangle(100, 100, 200, 200, AnnUnit.Pixel);
      rectObj.Pen = new AnnPen(Color.Blue, new AnnLength(2, AnnUnit.Pixel));
      rectObj.Brush = new AnnSolidBrush(Color.Yellow);

      // surround the changes to the automation by an undo
      automation.BeginUndo();

      automation.Container.Objects.Add(rectObj);

      // "select" this rectangle and make it ready for editing
      automation.StartEditing(rectObj, false);

      automation.EndUndo();
   }
}

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.

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 2000, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7

See Also

Leadtools.Annotations requires a Document or Medical toolkit license and unlock key. For more information, refer to: Imaging Pro/Document/Medical Features