Class ecm.widget.viewer.DocViewer

Extends dijit._Widget.
Provides a base class for all document viewer widgets. All document viewers in ICN have this widget/class as their base.
Defined in: <ecm\widget\viewer\DocViewer.js>.

Constructor Summary

Constructor Attributes	Constructor Name and Description
	ecm.widget.viewer.DocViewer()

Field Summary

Field Attributes	Field Name and Description
	docViewerClass  Sets the document viewer's CSS class for the DocViewer container.
	item  The item assigned to this doc viewer.
	preview  Indicates whether this instance of DocViewer is being used for preview.
	showErrorOnFallback  Indicates whether or not to show an error dialog, stating that no viewers are available to view a document, when the onFallback handler does not find a backup viewer.
	startingPage  The page to start on when initially opening the item to view.
	viewerDef  The instance of ecm.model.Viewer associated with this DocViewer instance.

Method Summary

Method Attributes	Method Name and Description
	canOpenItem(item) Determines if the viewer can open the item on the current client and mid-tier platforms.
	closeItem() Closes the item.
	delegateToDownload(item) Return true if the caller should initate the download action instead of showing the item in this viewer.
	getItem(callback, refresh) Get an instance of the item assigned to this viewer.
	getNativeViewer() Returns an instance of the object representing the native viewer implementation of this DocViewer, if available.
	getPageNumber() Returns the page number of the current page being viewed, if the viewer supports paging.
	ignoreDirty() Determines if the user should be prompted to save changes when isDirty is true.
	isAppletViewer() Determines if the viewer is Applet-based.
	isDirty() Determines if the viewer contains unsaved changes.
	isIframeViewer() Determines if the viewer is iframe-based.
	isLoaded() Determines if the document has completed loading.
	isLoading() Determines if the current document is in the process of being loaded.
	isLocked() Determines if the item being shown in the viewer is locked.
	isPluginViewer() Indicates whether the viewer uses a browser plugin.
	isPrinting() Determines if the viewer is printing the document.
	onDirty(dirty) Called when the contained viewer dirty state changes, either by acquiring unsaved changes, and when changes are saved.
	onDocumentLoaded() This event fires when the document has loaded.
	onFallback(notFoundCallback) Called when the viewer is unable to successfully open the document.
	onLoad() If this is an iframe-based viewer, this event fires for the iframe onload event
	onViewerFocusOut(movingup) Called when the contained viewer programmatically gives up focus.
	saveAnnotations(callback) Saves all annotation changes, if annotation editing is supported.
	setIsLoading(loading) Sets the loading status for this widget.
	setItem(item, pageNumber) Assigns an item to this viewer.
	showItem(callback) Displays the item, if an item has been set on this viewer.
	unloadIframe() If the viewer is an iframe viewer, this call sets its src to "about:blank".

Field Detail

docViewerClass

---

item

Deprecated:

This item property is not guaranteed to be in the correct window context, so it can only be used to obtain the document id/properties required for the viewer to obtain the document content and annotations. Use getItem instead.

---

preview

Since:

2.0.2

---

showErrorOnFallback

Since:

2.0.3

---

startingPage

Since:

2.0.2

---

viewerDef

Since:

2.0.2

Method Detail

{Boolean} canOpenItem(item)

Parameters:

item

The item to test.

Returns:

{Boolean} True or false, indicating whether this viewer can open the specified item.

---

closeItem()

---

delegateToDownload(item)

Parameters:

item

Since:

2.0.2

---

getItem(callback, refresh)

Parameters:

callback

The callback to call upon completion, the item instance will be passed as the sole parameter to this callback.

refresh

Specify true or false, to refresh the item properties.

Since:

2.0.3

---

getNativeViewer()

Since:

2.0.3.3

---

{number} getPageNumber()

Returns:

{number}

---

{Boolean} ignoreDirty()

Returns:

{Boolean} True or false, if the isDirty value sould be ignored.

---

{Boolean} isAppletViewer()

Returns:

{Boolean} True or false, if the viewer is Applet-based.

---

{Boolean} isDirty()

Returns:

{Boolean} True or false, if annotations have been added, modified, or deleted.

---

{Boolean} isIframeViewer()

Returns:

{Boolean} True or false, if the viewer is presented within an internal iframe

---

{Boolean} isLoaded()

Returns:

{Boolean} True or false, if loading and display of the document has completed.

---

{Boolean} isLoading()

Returns:

{Boolean} True or false, if the document is in the process of loading into the viewer.

---

{Boolean} isLocked()

Returns:

{Boolean} True or false, if the viewer has locked the item or sees the item as locked.

---

{Boolean} isPluginViewer()

Since:

2.0.3

Returns:

{Boolean} True or false, if the viewer is Plugin-based.

---

{Boolean} isPrinting()

Returns:

{Boolean} True or false, if the viewer is in the process of printing a document.

---

onDirty(dirty)

Parameters:

dirty

boolean indicating whether the new viewer state is dirty or not.

Since:

2.0.2

---

onDocumentLoaded()

---

onFallback(notFoundCallback)

Parameters:

notFoundCallback

If specified, this method will be called by the ContentViewer framework, when there is no fallback viewer available for the item being viewed.

---

onLoad()

---

onViewerFocusOut(movingup)

Parameters:

movingup

Boolean, to set to true if the focus out is the result of a shift-tab, otherwise false.

---

saveAnnotations(callback)

Parameters:

callback

If specified, call the callback upon completion of the save.

---

setIsLoading(loading)

Parameters:

loading

Since:

2.0.2

---

setItem(item, pageNumber)

Parameters:

item

The item being assigned to this viewer.

pageNumber

For document viewers that support page control, the page number to start on. If not specified, page 1 is assumed. (optional)

---

showItem(callback)

Parameters:

callback

The callback to call on successful completion of this call. (optional)

---

unloadIframe()

---