Class: ThumbnailControl

Constructor

new ThumbnailControl(domElement, viewerControl)

Creates a new PCCViewer.ThumbnailControl object.

Parameters:

Name	Type	Description
`domElement`	HTMLElement	The DOM element in which to embed the `ThumbnailControl`.
`viewerControl`	PCCViewer.ViewerControl	The `ViewerControl` object for which to display thumbnails.

See:

PCCViewer.ViewerControl

Throws:

If either of the parameters is undefined or an invalid value.

Type: Error

Members

(static, readonly) EventType :string

The EventType enumeration defines event types known to PCCViewer.ThumbnailControl.

Note: This enumeration is for convenience for API developers. Instead of using this enumeration, you can pass string values of the eventType (enumeration values)

Type:

string

Properties:

Name Type Description

Name	Type	Description
`PageSelectionChanged`	string	Event is triggered when the collection of selected thumbnails changes. Augmented properties of the PCCViewer.Event object for this event: `pageNumbers` {Array.<number>} The currently selected page numbers.

PageSelectionChanged

string

Event is triggered when the collection of selected thumbnails changes.

Augmented properties of the PCCViewer.Event object for this event:

pageNumbers {Array.<number>} The currently selected page numbers.

See:

selectedPages :Array.<number>|number

An ECMA 5 accessor property that is defined only in browsers supporting ECMA 5. This property is not available in the older browsers like IE8.

Gets and sets the selected pages in the Thumbnail Control.

Type:

Array.<number> | number

See:

(readonly) viewerControl :PCCViewer.ViewerControl

An ECMA 5 accessor property that is defined only in browsers supporting ECMA 5. This property is not available in the older browsers like IE8.

Gets the PCCViewer.ViewerControl object associated with this ThumbnailControl.

Type:

PCCViewer.ViewerControl

See:

PCCViewer.ThumbnailControl#getViewerControl

(readonly) visiblePages :Array.<number>

An ECMA 5 accessor property that is defined only in browsers supporting ECMA 5. This property is not available in the older browsers like IE8.

Gets the page numbers of the pages currently visible in the ThumbnailControl view.

Type:

Array.<number>

See:

PCCViewer.ThumbnailControl#getVisiblePages

Methods

destroy()

This method will remove the thumbnails from the original HTMLElement and return it to its previous state. It will destroy all of the thumbnails and release their resources. The ThumbnailControl can no longer be used after calling this method, and a new one will need to be created to continue viewing thumbnails.

getSelectedPages() → {Array.<number>}

Gets the currently selected thumbnails.

See:

Returns:

The page numbers of the selected thumbnails.

Type: Array.<number>

getViewerControl() → {PCCViewer.ViewerControl}

Gets the PCCViewer.ViewerControl object associated with this ThumbnailControl.

Returns:

The ViewerControl associated with this ThumbnailControl.

Type: PCCViewer.ViewerControl

getVisiblePages() → {Array.<number>}

Gets the page numbers of the pages currently visible in the ThumbnailControl view. This will include pages that are only partly visible, as well as pages that are not yet fully loaded but part of their placeholder is visible.

Returns:

An array of page numbers.

Type: Array.<number>

off(eventType, handler) → {PCCViewer.ThumbnailControl}

Unsubscribe an event handler from a specified event type.

Typically, an event is unsubscribed when you no longer want further notification of the event.

Parameters:

Name Type Description

Name	Type	Description
`eventType`	string	A string specifying the event type. See PCCViewer.ThumbnailControl.EventType for a list and description of all supported events.
`handler`	PCCViewer.Event~eventHandler	A function that was attached previously to the `ViewerControl`. Note: This must be the same function object previously passed to PCCViewer.ThumbnailControl#on. It cannot be an different object that is functionally equivalent.

eventType

string

A string specifying the event type. See PCCViewer.ThumbnailControl.EventType for a list and description of all supported events.

handler

PCCViewer.Event~eventHandler

A function that was attached previously to the ViewerControl.

Note: This must be the same function object previously passed to PCCViewer.ThumbnailControl#on. It cannot be an different object that is functionally equivalent.

See:

PCCViewer.ViewerControl#on
PCCViewer.ViewerControl#off for more details on usage.

Returns:

The ThumbnailControl object on which this method was called.

Type: PCCViewer.ThumbnailControl

on(eventType, handler) → {PCCViewer.ThumbnailControl}

Subscribe an event handler to an event of a specified type.

Parameters:

Name	Type	Description
`eventType`	string	A string that specifies the event type. This value is case-insensitive. See PCCViewer.ThumbnailControl.EventType for a list and description of all supported events.
`handler`	PCCViewer.Event~eventHandler	A function that will be called whenever the event is triggered.

See:

PCCViewer.ThumbnailControl#off
PCCViewer.ViewerControl#on for more details on usage.

Returns:

The ThumbnailControl object on which this method was called.

Type: PCCViewer.ThumbnailControl

reflow() → {PCCViewer.ThumbnailControl}

This method will calculate the size of a thumbnail based on the defined CSS, and will fit each individual page element to the thumbnail container. This method can also be called to programmatically trigger the loading of newly visible pages in cases where the thumbnail view either dynamically or manually changes size, or the thumbnails themselves change size.

Note: This method can be a bit expensive, so it is best to debounce it from any event that triggers a thumbnail resize, such as a window resize.

Returns:

The ThumbnailControl object on which this method was called.

Type: PCCViewer.ThumbnailControl

Example

// First, get the thumbnailControl

// Create a resize function
var resize = function(){
    thumbnailControl.reflow();
};

// Create a debounce function
var debounceTimer;
var debounceEvent = function(){
    if (debounceTimer) {
        clearTimeout(debounceTimer);
        debounceTimer = undefined;
    }

    debounceTimer = setTimeout(resize, 300);
};

// Add the debounced function to the resize event
window.onresize = debounceEvent;

scrollTo(pageNumber, optionsopt) → {PCCViewer.ThumbnailControl}

Scrolls to a specified page. By default, this will be done using the minimum amount of scrolling, so pages that are above the current view will be scrolled to appear at the top of the view, and pages below the current view will be scrolled to appear at the bottom. This can be overridden with the options parameter.

Parameters:

Name Type Attributes Description

pageNumber

number

The page to scroll to.

options

Object

Provide options to the scroll method to indicate desired behavior.

Properties

Name	Type	Attributes	Description
`forceAlignTop`	boolean	<optional>	Overrides the default scrolling behavior, and forces the specified page to always be scrolled to the top of the view.

Throws:

If the pageNumber is not within the range of the page count for the specified document.

Type: Error

Returns:

The ThumbnailControl object on which this method was called.

Type: PCCViewer.ThumbnailControl

setSelectedPages(pageNumbers) → {PCCViewer.ThumbnailControl}

Sets the currently selected thumbnails.

Parameters:

Name	Type	Description
`pageNumbers`	Array.<number> \| number	The page number (or numbers) to select. The first selected page will automatically be scrolled into view if it is not already visible. See PCCViewer.ThumbnailControl#scrollTo for more details on scrolling to a page.

See:

Throws:

If the pageNumbers parameter is undefined, or not a number or array of numbers.

Type

Error
If any of the numbers defined in pageNumbers is out of range of the document page count.

Type

Error

Returns:

The ThumbnailControl object on which this method was called.

Type: PCCViewer.ThumbnailControl