Package com.itextpdf.kernel.utils

Class PageRange

java.lang.Object

com.itextpdf.kernel.utils.PageRange

 public class PageRange extends Object 
      

Class representing a page range, for instance a page range can contain pages 5, then pages 10 through 15, then page 18, then page 21 and so on.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	PageRange.IPageRangePart	Inner interface for range parts definition
static class	PageRange.PageRangePartAfter	Class for range part containing a range of pages for all pages after a given start page
static class	PageRange.PageRangePartAnd	Class for range part based on several range parts.
static class	PageRange.PageRangePartOddEven	Class for range part for all even or odd pages.
static class	PageRange.PageRangePartSequence	Class for range part containing a range of pages represented by a start and an end page
static class	PageRange.PageRangePartSingle	Class for range part containing a single page

Constructor Summary

Constructors

Constructor	Description
PageRange()	Constructs an empty PageRange instance.
PageRange(String pageRange)	Constructs a PageRange instance from a range in a string form, for example: "1-12, 15, 45-66".

Method Summary

Modifier and Type	Method	Description
PageRange	addPageRangePart(PageRange.IPageRangePart part)	Adds any page range part to this page range.
PageRange	addPageSequence(int startPageNumber, int endPageNumber)	Adds a page sequence to the range.
PageRange	addSinglePage(int pageNumber)	Adds a single page to the range.
boolean	equals(Object obj)
List<Integer>	getQualifyingPageNums(int nbPages)	Gets the list of pages that have been added to the range so far.
int	hashCode()
boolean	isPageInRange(int pageNumber)	Checks if a given page is present in the range built so far.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Details

PageRange

 public PageRange() 
            

Constructs an empty PageRange instance.

PageRange

 public PageRange 
             (String pageRange) 
            

Constructs a PageRange instance from a range in a string form, for example: "1-12, 15, 45-66". More advanced forms are also available, for example: - "3-" to indicate from page 3 to the last page - "odd" for all odd pages - "even" for all even pages - "3- & odd" for all odd pages starting from page 3 A complete example for pages 1 to 5, page 8 then odd pages starting from page 9: "1-5, 8, odd & 9-".

Parameters:

pageRange - a String of page ranges

Method Details

addPageRangePart

 public PageRange addPageRangePart 
             (PageRange.IPageRangePart part) 
            

Adds any page range part to this page range. Users may define and plug in custom implementations for behavior not found in the standard library.

Parameters:

part - a custom implementation of PageRange.IPageRangePart

Returns:

this range, already modified

addPageSequence

 public PageRange addPageSequence 
             (int startPageNumber, int endPageNumber) 
            

Adds a page sequence to the range.

Parameters:

startPageNumber - the starting page number of the sequence

endPageNumber - the finishing page number of the sequence

Returns:

this range, already modified

addSinglePage

 public PageRange addSinglePage 
             (int pageNumber) 
            

Adds a single page to the range.

Parameters:

pageNumber - the page number to add

Returns:

this range, already modified

getQualifyingPageNums

 public List<Integer> getQualifyingPageNums 
             (int nbPages) 
            

Gets the list of pages that have been added to the range so far.

Parameters:

nbPages - number of pages of the document to get the pages, to list only the pages eligible for this document.

Returns:

the list containing page numbers added to the range matching this document

isPageInRange

 public boolean isPageInRange 
             (int pageNumber) 
            

Checks if a given page is present in the range built so far.

Parameters:

pageNumber - the page number to check

Returns:

true if the page is present in this range, false otherwise

equals

 public boolean equals 
             (Object obj) 
            

Overrides:

equals in class Object

hashCode

 public int hashCode() 
            

Overrides:

hashCode in class Object