getPageTextItems Method

Summary

Extract a DocumentViewerMultiLineTextItem between two positions.

Syntax

JavaScript Syntax

DocumentViewerText.prototype.getPageTextItems = function(begin, end)

TypeScript Syntax

getPageTextItems( 
   begin: DocumentViewerTextPosition, 
   end: DocumentViewerTextPosition 
   ): DocumentViewerMultiLineTextItem;

begin

A DocumentViewerTextPosition indicating the beginning of the range. Should not be null. Must include a valid page number.

end

A DocumentViewerTextPosition indicating the end of the range. Should not be null. Must include a valid page number.

A DocumentViewerMultiLineTextItem encompassing the range between the two parameter positions.

Remarks

If null is passed for either parameter, null is returned immediately. The method will check for valid page numbers in the Document, and then continue. The result is then guaranteed to be a DocumentViewerMultiLineTextItem, but DocumentViewerMultiLineTextItem.TextItems will be null if no DocumentViewerTextItem are found between the positions.

Each page between (and including) the given DocumentViewerTextPosition.PageNumber of begin and end is checked. If the DocumentViewerTextPosition.PageNumber of begin is greater than that of end, no DocumentViewerTextItem instances will be added to DocumentViewerMultiLineTextItem.TextItems. In other words, parameters are expected to be in order.

If the checked DocumentPageText is null or has no text, it is skipped.

History

Requirements

Help Version 19.0.2017.10.27