StartEditing Method

public virtual void StartEditing( 
   AnnObject annObject,
   bool group
)

'Declaration
 
Public Overridable Sub StartEditing( _
   ByVal annObject As AnnObject, _
   ByVal group As Boolean _
) 

'Usage
 
Dim instance As AnnAutomation
Dim annObject As AnnObject
Dim group As Boolean
 
instance.StartEditing(annObject, group)

public virtual void StartEditing( 
   AnnObject annObject,
   bool group
)

 function Leadtools.Annotations.AnnAutomation.StartEditing( 
   annObject ,
   group 
)

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.

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.

Calling StartEditing with group set to true might create a temporary group if more than one object will be selected, this will cause objects to be removed from the container and added into this temporary group. For example, you have a container with 3 objects (a line, a rectangle and an ellipse) and currently nothing is selected in the automation. Now you make the following call:

            automation.StartEditing(lineObject, true);
            

Since this is the first object to be selected, its edit designer will start. If you check automation.Container.Objects.Count it will still be 3. Next you make the following call:

            automation.StartEditing(rectangleObject, true);
            

This will instruct the automation object to add the rectangle to the current selection. The automation will create a temporary group object, add it to the container and them remove the line and ellipse objects from the container and adds them to this new group. If you check automation.Container.Objects.Count it will be 2, the group and the ellipse object. Next you make the following call:

            automation.StartEditing(ellipseObject, true);
            

This will instruct the automation object to add the ellipse to the current selection. The automation will remove the ellipse from the container and adds it to the group. If you check automation.Container.Objects.Count it will be 1, the group

With this information in mind, to select objects in an automation, you can either use SelectAll or use StartEditing with group set to true. However, you should not write code liks this:

            foreach(AnnObject obj in automation.Container.Objects)
              automation.StartEditing(obj, true);
            

As noted before, StartEditing might cause objects to be added or removed into the Objects collection. And you should never iterate a collection that will change like that. Instead, to select all (or a group) of objects manually, first get the references to these objects into an array or collection and then iterate through that collection:

            // Get a list of the objects to select, in this example, all of them
            AnnObject[] toSelectObjects = new AnnObject[automation.Container.Objects.Count];
            automation.Container.Objects.CopyTo(toSelectObjects, 0);
            // Call StartEditing on all these objects
            foreach (AnnObject obj in toSelectObjects)
               automation.StartEditing(obj, true);
            

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

AnnAutomation Class
AnnAutomation Members