setAnnotations Method (DocumentPage)

Summary

Replaces the annotations container for this page.

Syntax

JavaScript Syntax

DocumentPage.prototype.setAnnotations = function(container)

TypeScript Syntax

setAnnotations(container: AnnContainer): JQueryPromise<any>;

Parameters

container

New annotations container to use for this page. This value can be null.

Return Value

A voidPromise object that may resolve successfully.

Remarks

GetAnnotations is used to get the annotations container of this page. All document types support this method.

SetAnnotations is used to replace the annotation container of the page. IsAnnotationsModified is used to as flag that indicates that the annotations container of this page has been replaced by the user.

This method works as follows (the "item" is the new annotations container):

If the value of the IsReadOnly property of Document is true, then the user cannot modify this document and an exception will be thrown.
Any previously saved annotations container object for this page are purged from the cache.
container
is added to the cache by saving it using AnnCodecs. The original object is not deleted. If container is null, then a "null" item is added to the cache.

GetAnnotations will check the cache first, hence, subsequent calls will return the value set by this method.

The value of IsAnnotationsModified will be set to true after this method returns.

Note that you can use DocumentAnnotations.GetAnnotations and DocumentAnnotations.SetAnnotations to get or set an array of annotations container objects for one or more pages with a single call.

Refer to Loading Using LEADTOOLS Documents Library for more information.

Requirements

Target Platforms

See Also