This method returns the text of the content that has been assigned via the PageContents. If the PageContents is null then an exception will be raised.
The overloads of this function allow you to select an area of interest in terms of an area defined by single rectangle or by a union of multiple rectangles. They also allow you to select a subset of pages from which text should be returned. This page array is a set of page numbers - one based indexes - for which order is not important. Passing null for these parameters defaults to the entire page and the entire set of available pages respectively.
The process of getting the text involves scanning through the text fragments in the document and joining them up dependent on their positions and sizes. The result is a standard string with line ends where the line ends in the document have been found.
If there are parts of this string that you are interested in you can use the offset and length of the selections in conjunction with the Select method to identify those portions within the document.
|