setDocument Method

Summary

Sets a new document in the viewer.

Syntax

JavaScript Syntax

DocumentViewer.prototype.setDocument = function( 
   document 
)

TypeScript Syntax

setDocument( 
   document: Document 
): void;

Parameters

document

Document object to view. Use null to remove the current document from the viewer.

Remarks

If the value of document is null, then the current document is removed from the viewer.

If the viewer has a previous Document object set and this method was successful, then the existing Document object will be disposed if the value of AutoDisposeDocument is true.

The viewer will check if the value of document is the same as the existing one in the viewer. If so, it will not dispose the old document. The application can set the same document in the viewer as a "reset" or "reload" operation.

Encrypted documents must be decrypted prior to setting them in the viewer. Refer to Loading Encrypted Files Using the Documents Library for more information.

This method performs the following:

The Operation is invoked with DocumentViewerOperation.SetDocument, data1 and IsPostOperation set to false.
View, Thumbnails, Bookmarks and Annotations all may have background threads working to parse the existing document data. The document viewer will notify each object to abandon the work and exit the threads. This is performed in a graceful manner to preserve system resources and prevent memory leaks. Therefore, a slight delay might occur while the viewer waits on the threads to exit.
If the existing Document and the value of AutoDisposeDocument is true; then the Document object is disposed.
View, Thumbnails, Bookmarks and Annotations will be notified that a new document is set and to start new background threads if needed or populate the UI elements from the document pages and data. View and Thumbnails will use the value from UseAjaxImageLoading to determine how images are loaded (in addition to WorkerCount, LazyLoad, WorkerCount, and LazyLoad ).
Finally, the Operation is invoked again with DocumentViewerOperation.SetDocument, data1 and IsPostOperation set to true this time.