Append Method

Summary

Appends the changes between two versions of a container to the history.

Syntax
C#
VB
C++
Public Sub Append( 
   ByVal currentContainers() As AnnContainer, 
   ByVal updatedContainers() As AnnContainer 
) 
public:  
   void Append( 
      array<AnnContainer^>^ currentContainers, 
      array<AnnContainer^>^ updatedContainers 
   ) 

Parameters

currentContainers

The current (old) containers containing the original objects.

updatedContainers

The updated (new) containers with any changes.

Remarks

Append will compare the objects in the current and modified containers and add a new item in Items for each annotation object that has been changed.

This method works as follows:

  1. If a container is removed (is in currentContainer but not in updatedContainer), then an entry for all the AnnObject children of this container is added to Items with AnnHistoryItemState equals to Deleted.

  2. If a container is added (is in updatedContainer but not in currentContainer), then an entry for all the AnnObject children of this container is added to Items with AnnHistoryItemState equals to Added.

  3. Any object that is in updatedContainer but not in its equivalent container in currentContainer is considered a new object and an entry of type Added is added to Items.

  4. Any object that is in currentContainer but not in its equivalent container in updatedContainer is considered deleted and an entry of type Deleted is added to Items.

  5. For all objects that are in both currentContainer and its equivalent updatedContainer, the AnnObject.ModifiedMetadataKey values are compared and if not equal, an entry of type 'Modified' is added to Items.

Therefore, when this method returns, Items will be updated to add a list of all the annotation objects that have been changed between the two container sets.

Requirements

Target Platforms

Help Version 20.0.2020.3.31
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Annotations.Engine Assembly