SetAnnotations Method (DocumentAnnotations)

public void SetAnnotations( 
   AnnContainer[] containers
)

'Declaration
 

Public Sub SetAnnotations( _
   ByVal containers() As AnnContainer _
) 

'Usage
 

Dim instance As DocumentAnnotations
Dim containers() As AnnContainer
 
instance.SetAnnotations(containers)

public void setAnnotations(AnnContainer[] containers)
            

public:
void SetAnnotations( 
   array<AnnContainer^>^ containers
) 

Parameters

containers

An array of AnnContainer objects to update. The user must set the AnnContainer.PageNumber of each item to the desired value of the page(s) to be updated. if this value is null, then all the container of all the pages in document will be cleared (this is the equivalent of iterating through each DocumentPage in the document and calling SetAnnotations with null parameter).

GetAnnotations and SetAnnotations can be used to get or set an array of annotations container objects for all pages with a single call. Since the annotations can be stored in a stand-alone file, calling these optimized methods can be a lot faster than iterating through each page and calling DocumentPage.GetAnnotations or DocumentPage.SetAnnotations multiple times.

containers must contain an AnnContainer object for each page in the document to be updated. This method uses the value of AnnContainer.PageNumber to update the corresponding page(s) in the document. Any item that is null will be ignored.

The LEADTOOLS Document Viewer library uses GetAnnotations to obtain the annotation container objects for all pages at once instead of calling individual DocumentPage.GetAnnotations when a new document is loaded in the viewer. And will call SetAnnotations passing any annotation container that has changed by the user instead of DocumentPage.SetAnnotations in preparations for sending the document to the converter for saving.

Target Platforms

Reference

DocumentAnnotations Class
DocumentAnnotations Members