PdfDocument (iText 7 7.0.4 API)

java.lang.Object
- com.itextpdf.kernel.pdf.PdfDocument

All Implemented Interfaces:

IEventDispatcher, Closeable, Serializable, AutoCloseable

Direct Known Subclasses:

PdfADocument
```
public class PdfDocument
extends Object
implements IEventDispatcher, Closeable, Serializable
```
Main enter point to work with PDF document.

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`protected PdfCatalog`	`catalog` Document catalog.
`protected boolean`	`closed`
`protected boolean`	`closeReader`
`protected boolean`	`closeWriter`
`protected PdfPage`	`currentPage` Currently active page.
`protected PageSize`	`defaultPageSize` Default page size.
`protected EventDispatcher`	`eventDispatcher`
`protected boolean`	`flushUnusedObjects` flag determines whether to write unused objects to result document
`protected PdfDocumentInfo`	`info` Document info.
`protected PdfString`	`initialDocumentId` Deprecated.
`protected boolean`	`isClosing`
`protected PdfString`	`modifiedDocumentId` Deprecated.
`protected PdfVersion`	`pdfVersion` Document version.
`protected StampingProperties`	`properties`
`protected PdfReader`	`reader` PdfReader associated with the document.
`protected int`	`structParentIndex`
`protected PdfStructTreeRoot`	`structTreeRoot`
`protected TagStructureContext`	`tagStructureContext`
`protected PdfDictionary`	`trailer` Document trailed.
`protected boolean`	`userProperties`
`protected PdfWriter`	`writer` PdfWriter associated with the document.
`protected byte[]`	`xmpMetadata` XMP Metadata for the document.

Constructor Summary

Constructors
Constructor and Description
`PdfDocument(PdfReader reader)` Open PDF document in reading mode.
`PdfDocument(PdfReader reader, PdfWriter writer)` Opens PDF document in the stamping mode.
`PdfDocument(PdfReader reader, PdfWriter writer, StampingProperties properties)` Open PDF document in stamping mode.
`PdfDocument(PdfWriter writer)` Open PDF document in writing mode.

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`protected void`	`addCustomMetadataExtensions(XMPMeta xmpMeta)` Adds custom XMP metadata extension.
`void`	`addEventHandler(String type, IEventHandler handler)` Adds new event handler.
`void`	`addFileAttachment(String description, byte[] fileStore, String fileDisplay, PdfName mimeType, PdfDictionary fileParameter, PdfName afRelationshipValue)` Adds file attachment at document level.
`void`	`addFileAttachment(String description, PdfFileSpec fs)` Adds file attachment at document level.
`void`	`addFileAttachment(String description, String file, String fileDisplay, PdfName mimeType, PdfName afRelationshipValue)` Adds file attachment at document level.
`PdfFont`	`addFont(PdfFont font)` Adds a `PdfFont` instance to this document so that this font is flushed automatically on document close.
`void`	`addNamedDestination(String key, PdfObject value)` This methods adds new name in the Dests NameTree.
`PdfPage`	`addNewPage()` Creates and adds new page to the end of document.
`PdfPage`	`addNewPage(int index)` Creates and inserts new page to the document.
`PdfPage`	`addNewPage(int index, PageSize pageSize)` Creates and inserts new page to the document.
`PdfPage`	`addNewPage(PageSize pageSize)` Creates and adds new page with the specified page size.
`void`	`addOutputIntent(PdfOutputIntent outputIntent)` Adds `PdfOutputIntent` that shall specify the colour characteristics of output devices on which the document might be rendered.
`PdfPage`	`addPage(int index, PdfPage page)` Inserts page to the document.
`PdfPage`	`addPage(PdfPage page)` Adds page to the end of document.
`protected void`	`checkAndAddPage(int index, PdfPage page)` Checks page before adding and add.
`protected void`	`checkAndAddPage(PdfPage page)` Checks page before adding.
`protected void`	`checkClosingStatus()` checks whether a method is invoked at the closed document
`protected void`	`checkIsoConformance()` Checks whether PDF document conforms a specific standard.
`void`	`checkIsoConformance(Object obj, IsoKey key)` Checks whether PDF document conforms a specific standard.
`void`	`checkIsoConformance(Object obj, IsoKey key, PdfResources resources)` Checks whether PDF document conforms a specific standard.
`void`	`checkShowTextIsoConformance(Object gState, PdfResources resources)` Checks whether PDF document conforms a specific standard.
`void`	`close()` Close PDF document.
`List<PdfPage>`	`copyPagesTo(int pageFrom, int pageTo, PdfDocument toDocument)` Copies a range of pages from current document to `toDocument` appending copied pages to the end.
`List<PdfPage>`	`copyPagesTo(int pageFrom, int pageTo, PdfDocument toDocument, int insertBeforePage)` Copies a range of pages from current document to `toDocument`.
`List<PdfPage>`	`copyPagesTo(int pageFrom, int pageTo, PdfDocument toDocument, int insertBeforePage, IPdfPageExtraCopier copier)` Copies a range of pages from current document to `toDocument`.
`List<PdfPage>`	`copyPagesTo(int pageFrom, int pageTo, PdfDocument toDocument, IPdfPageExtraCopier copier)` Copies a range of pages from current document to `toDocument` appending copied pages to the end.
`List<PdfPage>`	`copyPagesTo(List<Integer> pagesToCopy, PdfDocument toDocument)` Copies a range of pages from current document to `toDocument` appending copied pages to the end.
`List<PdfPage>`	`copyPagesTo(List<Integer> pagesToCopy, PdfDocument toDocument, int insertBeforePage)` Copies a range of pages from current document to `toDocument`.
`List<PdfPage>`	`copyPagesTo(List<Integer> pagesToCopy, PdfDocument toDocument, int insertBeforePage, IPdfPageExtraCopier copier)` Copies a range of pages from current document to `toDocument`.
`List<PdfPage>`	`copyPagesTo(List<Integer> pagesToCopy, PdfDocument toDocument, IPdfPageExtraCopier copier)` Copies a range of pages from current document to `toDocument` appending copied pages to the end.
`PdfIndirectReference`	`createNextIndirectReference()` Creates next available indirect reference.
`void`	`dispatchEvent(Event event)` Dispatches an event.
`void`	`dispatchEvent(Event event, boolean delayed)` Dispatches a delayed event.
`void`	`flushCopiedObjects(PdfDocument sourceDoc)` Flush all copied objects and remove them from copied cache.
`protected void`	`flushFonts()`
`protected void`	`flushObject(PdfObject pdfObject, boolean canBeInObjStm)` Flush an object.
`PdfCatalog`	`getCatalog()` Gets PDF catalog.
`protected Counter`	`getCounter()` Gets `Counter` instance.
`PdfFont`	`getDefaultFont()` Gets default font for the document: Helvetica, WinAnsi.
`PageSize`	`getDefaultPageSize()` Gets default page size.
`protected Collection<PdfFont>`	`getDocumentFonts()` List all newly added or loaded fonts
`PdfDocumentInfo`	`getDocumentInfo()` Gets document information dictionary.
`PdfPage`	`getFirstPage()` Get the first page of the document.
`PdfFont`	`getFont(PdfDictionary dictionary)` Create a new instance of `PdfFont` or load already created one.
`PdfPage`	`getLastPage()` Gets the last page of the document.
`int`	`getNextStructParentIndex()` Gets next parent index of tagged document.
`int`	`getNumberOfPages()` Gets number of pages of the document.
`int`	`getNumberOfPdfObjects()` Get number of indirect objects in the document.
`PdfOutline`	`getOutlines(boolean updateOutlines)` This method returns a complete outline tree of the whole document.
`PdfPage`	`getPage(int pageNum)` Gets the page by page number.
`PdfPage`	`getPage(PdfDictionary pageDictionary)` Gets the `PdfPage` instance by `PdfDictionary`.
`String[]`	`getPageLabels()` This method retrieves the page labels from a document as an array of String objects.
`int`	`getPageNumber(PdfDictionary pageDictionary)` Gets page number by `PdfDictionary`.
`int`	`getPageNumber(PdfPage page)` Gets page number by page.
`PdfObject`	`getPdfObject(int objNum)` Gets PdfObject by object number.
`PdfVersion`	`getPdfVersion()` Gets PDF version.
`PdfReader`	`getReader()` Gets `PdfReader` associated with the document.
`PdfStructTreeRoot`	`getStructTreeRoot()` Gets `PdfStructTreeRoot` of tagged document.
`TagStructureContext`	`getTagStructureContext()` Gets document `TagStructureContext`.
`PdfDictionary`	`getTrailer()` Gets document trailer.
`PdfWriter`	`getWriter()` Gets `PdfWriter` associated with the document.
`byte[]`	`getXmpMetadata()` Gets XMPMetadata.
`byte[]`	`getXmpMetadata(boolean createNew)` Gets XMPMetadata or create a new one.
`boolean`	`hasEventHandler(String type)` Checks if event dispatcher as an event handler assigned for a certain event type.
`boolean`	`hasOutlines()` Indicates if the document has any outlines
`void`	`initializeOutlines()` This method initializes an outline tree of the document and sets outline mode to true.
`protected void`	`initTagStructureContext()` Initialize `TagStructureContext`.
`boolean`	`isAppendMode()` Returns `true` if the document is opened in append mode, and `false` otherwise.
`boolean`	`isClosed()` Gets close status of the document.
`boolean`	`isCloseReader()` Checks, whether `close()` method will close associated PdfReader.
`boolean`	`isCloseWriter()` Checks, whether `close()` method will close associated PdfWriter.
`boolean`	`isFlushUnusedObjects()` Checks, whether `close()` will flush unused objects, e.g.
`boolean`	`isTagged()` Gets tagged status of the document.
`List<PdfIndirectReference>`	`listIndirectReferences()` Gets static copy of cross reference table.
`protected void`	`markObjectAsMustBeFlushed(PdfObject pdfObject)` Mark an object with `PdfObject.MUST_BE_FLUSHED`.
`protected void`	`open(PdfVersion newPdfVersion)` Initializes document.
`void`	`removeAllHandlers()` Remove all event handlers.
`void`	`removeEventHandler(String type, IEventHandler handler)` Removes event handler.
`PdfPage`	`removePage(int pageNum)` Removes page from the document by page number.
`boolean`	`removePage(PdfPage page)` Removes the first occurrence of the specified page from this document, if it is present.
`void`	`setCloseReader(boolean closeReader)` Sets, whether `close()` method shall close associated PdfReader.
`void`	`setCloseWriter(boolean closeWriter)` Sets, whether `close()` method shall close associated PdfWriter.
`void`	`setDefaultPageSize(PageSize pageSize)` Sets default page size.
`void`	`setFlushUnusedObjects(boolean flushUnusedObjects)` Sets, whether `close()` shall flush unused objects, e.g.
`void`	`setInitialDocumentId(PdfString initialDocumentId)` Deprecated. Will be removed in 7.1. Use `WriterProperties.setInitialDocumentId(PdfString)` instead
`void`	`setModifiedDocumentId(PdfString modifiedDocumentId)` Deprecated. Will be removed in 7.1. Use `WriterProperties.setModifiedDocumentId(PdfString)` instead
`void`	`setTagged()`
`void`	`setUserProperties(boolean userProperties)` Sets the flag indicating the presence of structure elements that contain user properties attributes.
`protected void`	`setXmpMetadata(byte[] xmpMetadata)` Use this method to set the XMP Metadata.
`void`	`setXmpMetadata(XMPMeta xmpMeta)`
`void`	`setXmpMetadata(XMPMeta xmpMeta, SerializeOptions serializeOptions)`
`protected void`	`storeLinkAnnotation(PdfPage page, PdfLinkAnnotation annotation)` Save the link annotation in a temporary storage for further copying.
`protected XMPMeta`	`updateDefaultXmpMetadata()` Update XMP metadata values from `PdfDocumentInfo`.
`protected void`	`updateXmpMetadata()` Updates XMP metadata.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - currentPage
```
protected PdfPage currentPage
```
    Currently active page.
  - defaultPageSize
```
protected PageSize defaultPageSize
```
    Default page size. New page by default will be created with this size.
  - eventDispatcher
```
protected transient EventDispatcher eventDispatcher
```
  - writer
```
protected PdfWriter writer
```
    PdfWriter associated with the document. Not null if document opened either in writing or stamping mode.
  - reader
```
protected PdfReader reader
```
    PdfReader associated with the document. Not null if document is opened either in reading or stamping mode.
  - xmpMetadata
```
protected byte[] xmpMetadata
```
    XMP Metadata for the document.
  - catalog
```
protected PdfCatalog catalog
```
    Document catalog.
  - trailer
```
protected PdfDictionary trailer
```
    Document trailed.
  - info
```
protected PdfDocumentInfo info
```
    Document info.
  - pdfVersion
```
protected PdfVersion pdfVersion
```
    Document version.
  - initialDocumentId
```
@Deprecated
protected PdfString initialDocumentId
```
    Deprecated.
    
    The ID entry that represents the initial identifier.
  - modifiedDocumentId
```
@Deprecated
protected PdfString modifiedDocumentId
```
    Deprecated.
    
    The ID entry that represents a change in a document.
  - properties
```
protected final StampingProperties properties
```
  - structTreeRoot
```
protected PdfStructTreeRoot structTreeRoot
```
  - structParentIndex
```
protected int structParentIndex
```
  - userProperties
```
protected boolean userProperties
```
  - closeReader
```
protected boolean closeReader
```
  - closeWriter
```
protected boolean closeWriter
```
  - isClosing
```
protected boolean isClosing
```
  - closed
```
protected boolean closed
```
  - flushUnusedObjects
```
protected boolean flushUnusedObjects
```
    flag determines whether to write unused objects to result document
  - tagStructureContext
```
protected transient TagStructureContext tagStructureContext
```
- Constructor Detail
  - PdfDocument
```
public PdfDocument(PdfReader reader)
```
    Open PDF document in reading mode.
    
    Parameters:
    
    reader - PDF reader.
  - PdfDocument
```
public PdfDocument(PdfWriter writer)
```
    Open PDF document in writing mode. Document has no pages when initialized.
    
    Parameters:
    
    writer - PDF writer
  - PdfDocument
```
public PdfDocument(PdfReader reader,
                   PdfWriter writer)
```
    Opens PDF document in the stamping mode.
    
    Parameters:
    
    reader - PDF reader.
    
    writer - PDF writer.
  - PdfDocument
```
public PdfDocument(PdfReader reader,
                   PdfWriter writer,
                   StampingProperties properties)
```
    Open PDF document in stamping mode.
    
    Parameters:
    
    reader - PDF reader.
    
    writer - PDF writer.
    
    properties - properties of the stamping process
- Method Detail
  - setXmpMetadata
```
protected void setXmpMetadata(byte[] xmpMetadata)
```
    Use this method to set the XMP Metadata.
    
    Parameters:
    
    xmpMetadata - The xmpMetadata to set.
  - setXmpMetadata
```
public void setXmpMetadata(XMPMeta xmpMeta,
                           SerializeOptions serializeOptions)
                    throws XMPException
```
    Throws:
    
    XMPException
  - setXmpMetadata
```
public void setXmpMetadata(XMPMeta xmpMeta)
                    throws XMPException
```
    Throws:
    
    XMPException
  - getXmpMetadata
```
public byte[] getXmpMetadata()
```
    Gets XMPMetadata.
  - getXmpMetadata
```
public byte[] getXmpMetadata(boolean createNew)
```
    Gets XMPMetadata or create a new one.
    
    Parameters:
    
    createNew - if true, create a new empty XMPMetadata if it did not present.
    
    Returns:
    
    existed or newly created XMPMetadata byte array.
  - getPdfObject
```
public PdfObject getPdfObject(int objNum)
```
    Gets PdfObject by object number.
    
    Parameters:
    
    objNum - object number.
    
    Returns:
    
    PdfObject or null, if object not found.
  - getNumberOfPdfObjects
```
public int getNumberOfPdfObjects()
```
    Get number of indirect objects in the document.
    
    Returns:
    
    number of indirect objects.
  - getPage
```
public PdfPage getPage(int pageNum)
```
    Gets the page by page number.
    
    Parameters:
    
    pageNum - page number.
    
    Returns:
    
    page by page number.
  - getPage
```
public PdfPage getPage(PdfDictionary pageDictionary)
```
    Gets the PdfPage instance by PdfDictionary.
    
    Parameters:
    
    pageDictionary - PdfDictionary that present page.
    
    Returns:
    
    page by PdfDictionary.
  - getFirstPage
```
public PdfPage getFirstPage()
```
    Get the first page of the document.
    
    Returns:
    
    first page of the document.
  - getLastPage
```
public PdfPage getLastPage()
```
    Gets the last page of the document.
    
    Returns:
    
    last page.
  - addNewPage
```
public PdfPage addNewPage()
```
    Creates and adds new page to the end of document.
    
    Returns:
    
    added page
  - addNewPage
```
public PdfPage addNewPage(PageSize pageSize)
```
    Creates and adds new page with the specified page size.
    
    Parameters:
    
    pageSize - page size of the new page
    
    Returns:
    
    added page
  - addNewPage
```
public PdfPage addNewPage(int index)
```
    Creates and inserts new page to the document.
    
    Parameters:
    
    index - position to addPage page to
    
    Returns:
    
    inserted page
    
    Throws:
    
    PdfException - in case page is flushed
  - addNewPage
```
public PdfPage addNewPage(int index,
                          PageSize pageSize)
```
    Creates and inserts new page to the document.
    
    Parameters:
    
    index - position to addPage page to
    
    pageSize - page size of the new page
    
    Returns:
    
    inserted page
    
    Throws:
    
    PdfException - in case page is flushed
  - addPage
```
public PdfPage addPage(PdfPage page)
```
    Adds page to the end of document.
    
    Parameters:
    
    page - page to add.
    
    Returns:
    
    added page.
    
    Throws:
    
    PdfException - in case page is flushed
  - addPage
```
public PdfPage addPage(int index,
                       PdfPage page)
```
    Inserts page to the document.
    
    Parameters:
    
    index - position to addPage page to
    
    page - page to addPage
    
    Returns:
    
    inserted page
    
    Throws:
    
    PdfException - in case page is flushed
  - getNumberOfPages
```
public int getNumberOfPages()
```
    Gets number of pages of the document.
    
    Returns:
    
    number of pages.
  - getPageNumber
```
public int getPageNumber(PdfPage page)
```
    Gets page number by page.
    
    Parameters:
    
    page - the page.
    
    Returns:
    
    page number.
  - getPageNumber
```
public int getPageNumber(PdfDictionary pageDictionary)
```
    Gets page number by PdfDictionary.
    
    Parameters:
    
    pageDictionary - PdfDictionary that present page.
    
    Returns:
    
    page number by PdfDictionary.
  - removePage
```
public boolean removePage(PdfPage page)
```
    Removes the first occurrence of the specified page from this document, if it is present. Returns true if this document contained the specified element (or equivalently, if this document changed as a result of the call).
    
    Parameters:
    
    page - page to be removed from this document, if present
    
    Returns:
    
    true if this document contained the specified page
  - removePage
```
public PdfPage removePage(int pageNum)
```
    Removes page from the document by page number.
    
    Parameters:
    
    pageNum - the one-based index of the PdfPage to be removed
    
    Returns:
    
    the page that was removed from the list
  - getDocumentInfo
```
public PdfDocumentInfo getDocumentInfo()
```
    Gets document information dictionary.
    
    Returns:
    
    document information dictionary.
  - getDefaultPageSize
```
public PageSize getDefaultPageSize()
```
    Gets default page size.
    
    Returns:
    
    default page size.
  - setDefaultPageSize
```
public void setDefaultPageSize(PageSize pageSize)
```
    Sets default page size.
    
    Parameters:
    
    pageSize - page size to be set as default.
  - addEventHandler
```
public void addEventHandler(String type,
                            IEventHandler handler)
```
    Adds new event handler.
    
    Specified by:
    
    addEventHandler in interface IEventDispatcher
    
    Parameters:
    
    type - a type of event to be handled.
    
    handler - event handler.
  - dispatchEvent
```
public void dispatchEvent(Event event)
```
    Dispatches an event.
    
    Specified by:
    
    dispatchEvent in interface IEventDispatcher
  - dispatchEvent
```
public void dispatchEvent(Event event,
                          boolean delayed)
```
    Dispatches a delayed event. Sometimes event cannot be handled immediately because event handler has not been set yet. In this case event is placed into event ques of dispatcher and is waiting until handler is assigned.
    
    Specified by:
    
    dispatchEvent in interface IEventDispatcher
  - hasEventHandler
```
public boolean hasEventHandler(String type)
```
    Checks if event dispatcher as an event handler assigned for a certain event type.
    
    Specified by:
    
    hasEventHandler in interface IEventDispatcher
  - removeEventHandler
```
public void removeEventHandler(String type,
                               IEventHandler handler)
```
    Removes event handler.
    
    Specified by:
    
    removeEventHandler in interface IEventDispatcher
  - removeAllHandlers
```
public void removeAllHandlers()
```
    Remove all event handlers.
    
    Specified by:
    
    removeAllHandlers in interface IEventDispatcher
  - getWriter
```
public PdfWriter getWriter()
```
    Gets PdfWriter associated with the document.
    
    Returns:
    
    PdfWriter associated with the document.
  - getReader
```
public PdfReader getReader()
```
    Gets PdfReader associated with the document.
    
    Returns:
    
    PdfReader associated with the document.
  - isAppendMode
```
public boolean isAppendMode()
```
    Returns true if the document is opened in append mode, and false otherwise.
    
    Returns:
    
    true if the document is opened in append mode, and false otherwise.
  - createNextIndirectReference
```
public PdfIndirectReference createNextIndirectReference()
```
    Creates next available indirect reference.
    
    Returns:
    
    created indirect reference.
  - getPdfVersion
```
public PdfVersion getPdfVersion()
```
    Gets PDF version.
    
    Returns:
    
    PDF version.
  - getCatalog
```
public PdfCatalog getCatalog()
```
    Gets PDF catalog.
    
    Returns:
    
    PDF catalog.
  - close
```
public void close()
```
    Close PDF document.
    
    Specified by:
    
    close in interface Closeable
    
    Specified by:
    
    close in interface AutoCloseable
  - isClosed
```
public boolean isClosed()
```
    Gets close status of the document.
    
    Returns:
    
    true, if the document has already been closed, otherwise false.
  - isTagged
```
public boolean isTagged()
```
    Gets tagged status of the document.
    
    Returns:
    
    true, if the document has tag structure, otherwise false.
  - setTagged
```
public void setTagged()
```
  - getStructTreeRoot
```
public PdfStructTreeRoot getStructTreeRoot()
```
    Gets PdfStructTreeRoot of tagged document.
    
    Returns:
    
    PdfStructTreeRoot in case tagged document, otherwise false.
    
    See Also:
    
    isTagged(), getNextStructParentIndex()
  - getNextStructParentIndex
```
public int getNextStructParentIndex()
```
    Gets next parent index of tagged document.
    
    Returns:
    
    -1 if document is not tagged, or >= 0 if tagged.
    
    See Also:
    
    isTagged(), getNextStructParentIndex()
  - getTagStructureContext
```
public TagStructureContext getTagStructureContext()
```
    Gets document TagStructureContext. The document must be tagged, otherwise an exception will be thrown.
    
    Returns:
    
    document TagStructureContext.
  - copyPagesTo
```
public List<PdfPage> copyPagesTo(int pageFrom,
                                 int pageTo,
                                 PdfDocument toDocument,
                                 int insertBeforePage)
```
    Copies a range of pages from current document to toDocument. Use this method if you want to copy pages across tagged documents. This will keep resultant PDF structure consistent.
    
    Parameters:
    
    pageFrom - start of the range of pages to be copied.
    
    pageTo - end of the range of pages to be copied.
    
    toDocument - a document to copy pages to.
    
    insertBeforePage - a position where to insert copied pages.
    
    Returns:
    
    list of copied pages
  - copyPagesTo
```
public List<PdfPage> copyPagesTo(int pageFrom,
                                 int pageTo,
                                 PdfDocument toDocument,
                                 int insertBeforePage,
                                 IPdfPageExtraCopier copier)
```
    Copies a range of pages from current document to toDocument. Use this method if you want to copy pages across tagged documents. This will keep resultant PDF structure consistent.
    
    Parameters:
    
    pageFrom - 1-based start of the range of pages to be copied.
    
    pageTo - 1-based end of the range of pages to be copied.
    
    toDocument - a document to copy pages to.
    
    insertBeforePage - a position where to insert copied pages.
    
    copier - a copier which bears a special copy logic. May be null. It is recommended to use the same instance of IPdfPageExtraCopier for the same output document.
    
    Returns:
    
    list of new copied pages
  - copyPagesTo
```
public List<PdfPage> copyPagesTo(int pageFrom,
                                 int pageTo,
                                 PdfDocument toDocument)
```
    Copies a range of pages from current document to toDocument appending copied pages to the end. Use this method if you want to copy pages across tagged documents. This will keep resultant PDF structure consistent.
    
    Parameters:
    
    pageFrom - 1-based start of the range of pages to be copied.
    
    pageTo - 1-based end of the range of pages to be copied.
    
    toDocument - a document to copy pages to.
    
    Returns:
    
    list of new copied pages
  - copyPagesTo
```
public List<PdfPage> copyPagesTo(int pageFrom,
                                 int pageTo,
                                 PdfDocument toDocument,
                                 IPdfPageExtraCopier copier)
```
    Copies a range of pages from current document to toDocument appending copied pages to the end. Use this method if you want to copy pages across tagged documents. This will keep resultant PDF structure consistent.
    
    Parameters:
    
    pageFrom - 1-based start of the range of pages to be copied.
    
    pageTo - 1-based end of the range of pages to be copied.
    
    toDocument - a document to copy pages to.
    
    copier - a copier which bears a special copy logic. May be null. It is recommended to use the same instance of IPdfPageExtraCopier for the same output document.
    
    Returns:
    
    list of new copied pages.
  - copyPagesTo
```
public List<PdfPage> copyPagesTo(List<Integer> pagesToCopy,
                                 PdfDocument toDocument,
                                 int insertBeforePage)
```
    Copies a range of pages from current document to toDocument. Use this method if you want to copy pages across tagged documents. This will keep resultant PDF structure consistent.
    
    Parameters:
    
    pagesToCopy - list of pages to be copied. TreeSet for the order of the pages to be natural.
    
    toDocument - a document to copy pages to.
    
    insertBeforePage - a position where to insert copied pages.
    
    Returns:
    
    list of new copied pages
  - copyPagesTo
```
public List<PdfPage> copyPagesTo(List<Integer> pagesToCopy,
                                 PdfDocument toDocument,
                                 int insertBeforePage,
                                 IPdfPageExtraCopier copier)
```
    Copies a range of pages from current document to toDocument. Use this method if you want to copy pages across tagged documents. This will keep resultant PDF structure consistent.
    
    Parameters:
    
    pagesToCopy - list of pages to be copied. TreeSet for the order of the pages to be natural.
    
    toDocument - a document to copy pages to.
    
    insertBeforePage - a position where to insert copied pages.
    
    copier - a copier which bears a special copy logic. May be null. It is recommended to use the same instance of IPdfPageExtraCopier for the same output document.
    
    Returns:
    
    list of new copied pages
  - copyPagesTo
```
public List<PdfPage> copyPagesTo(List<Integer> pagesToCopy,
                                 PdfDocument toDocument)
```
    Copies a range of pages from current document to toDocument appending copied pages to the end. Use this method if you want to copy pages across tagged documents. This will keep resultant PDF structure consistent.
    
    Parameters:
    
    pagesToCopy - list of pages to be copied. TreeSet for the order of the pages to be natural.
    
    toDocument - a document to copy pages to.
    
    Returns:
    
    list of copied pages
  - copyPagesTo
```
public List<PdfPage> copyPagesTo(List<Integer> pagesToCopy,
                                 PdfDocument toDocument,
                                 IPdfPageExtraCopier copier)
```
    Copies a range of pages from current document to toDocument appending copied pages to the end. Use this method if you want to copy pages across tagged documents. This will keep resultant PDF structure consistent.
    
    Parameters:
    
    pagesToCopy - list of pages to be copied. TreeSet for the order of the pages to be natural.
    
    toDocument - a document to copy pages to.
    
    copier - a copier which bears a special copy logic. May be null. It is recommended to use the same instance of IPdfPageExtraCopier for the same output document.
    
    Returns:
    
    list of copied pages
  - flushCopiedObjects
```
public void flushCopiedObjects(PdfDocument sourceDoc)
```
    Flush all copied objects and remove them from copied cache. Note, if you will copy objects from the same document, doublicated objects will be created.
    
    Parameters:
    
    sourceDoc - source document
  - isCloseReader
```
public boolean isCloseReader()
```
    Checks, whether close() method will close associated PdfReader.
    
    Returns:
    
    true, close() method is going to close associated PdfReader, otherwise false.
  - setCloseReader
```
public void setCloseReader(boolean closeReader)
```
    Sets, whether close() method shall close associated PdfReader.
    
    Parameters:
    
    closeReader - true, close() method shall close associated PdfReader, otherwise false.
  - isCloseWriter
```
public boolean isCloseWriter()
```
    Checks, whether close() method will close associated PdfWriter.
    
    Returns:
    
    true, close() method is going to close associated PdfWriter, otherwise false.
  - setCloseWriter
```
public void setCloseWriter(boolean closeWriter)
```
    Sets, whether close() method shall close associated PdfWriter.
    
    Parameters:
    
    closeWriter - true, close() method shall close associated PdfWriter, otherwise false.
  - isFlushUnusedObjects
```
public boolean isFlushUnusedObjects()
```
    Checks, whether close() will flush unused objects, e.g. unreachable from PDF Catalog. By default - false.
    
    Returns:
    
    false, if close() shall not flush unused objects, otherwise true.
  - setFlushUnusedObjects
```
public void setFlushUnusedObjects(boolean flushUnusedObjects)
```
    Sets, whether close() shall flush unused objects, e.g. unreachable from PDF Catalog.
    
    Parameters:
    
    flushUnusedObjects - false, if close() shall not flush unused objects, otherwise true.
  - getOutlines
```
public PdfOutline getOutlines(boolean updateOutlines)
```
    This method returns a complete outline tree of the whole document.
    
    Parameters:
    
    updateOutlines - if the flag is true, the method read the whole document and creates outline tree. If false the method gets cached outline tree (if it was cached via calling getOutlines method before).
    
    Returns:
    
    fully initialize PdfOutline object.
  - initializeOutlines
```
public void initializeOutlines()
```
    This method initializes an outline tree of the document and sets outline mode to true.
  - addNamedDestination
```
public void addNamedDestination(String key,
                                PdfObject value)
```
    This methods adds new name in the Dests NameTree. It throws an exception, if the name already exists.
    
    Parameters:
    
    key - Name of the destination.
    
    value - An object destination refers to. Must be an array or a dictionary with key /D and array. See ISO 32000-1 12.3.2.3 for more info.
  - listIndirectReferences
```
public List<PdfIndirectReference> listIndirectReferences()
```
    Gets static copy of cross reference table.
  - getTrailer
```
public PdfDictionary getTrailer()
```
    Gets document trailer.
    
    Returns:
    
    document trailer.
  - addOutputIntent
```
public void addOutputIntent(PdfOutputIntent outputIntent)
```
    Adds PdfOutputIntent that shall specify the colour characteristics of output devices on which the document might be rendered.
    
    Parameters:
    
    outputIntent - PdfOutputIntent to add.
    
    See Also:
    
    PdfOutputIntent
  - checkIsoConformance
```
public void checkIsoConformance(Object obj,
                                IsoKey key)
```
    Checks whether PDF document conforms a specific standard. Shall be override.
    
    Parameters:
    
    obj - An object to conform.
    
    key - type of object to conform.
  - checkIsoConformance
```
public void checkIsoConformance(Object obj,
                                IsoKey key,
                                PdfResources resources)
```
    Checks whether PDF document conforms a specific standard. Shall be override.
    
    Parameters:
    
    obj - an object to conform.
    
    key - type of object to conform.
    
    resources - PdfResources associated with an object to check.
  - checkShowTextIsoConformance
```
public void checkShowTextIsoConformance(Object gState,
                                        PdfResources resources)
```
    Checks whether PDF document conforms a specific standard. Shall be override.
    
    Parameters:
    
    gState - a CanvasGraphicsState object to conform.
    
    resources - PdfResources associated with an object to check.
  - addFileAttachment
```
public void addFileAttachment(String description,
                              byte[] fileStore,
                              String fileDisplay,
                              PdfName mimeType,
                              PdfDictionary fileParameter,
                              PdfName afRelationshipValue)
```
    Adds file attachment at document level.
    
    Parameters:
    
    description - the file description
    
    fileStore - an array with the file.
    
    fileDisplay - the actual file name stored in the pdf
    
    mimeType - mime type of the file
    
    fileParameter - the optional extra file parameters such as the creation or modification date
    
    afRelationshipValue - if null, PdfName.Unspecified will be added. Shall be one of: PdfName.Source, PdfName.Data, PdfName.Alternative, PdfName.Supplement or PdfName.Unspecified.
  - addFileAttachment
```
public void addFileAttachment(String description,
                              String file,
                              String fileDisplay,
                              PdfName mimeType,
                              PdfName afRelationshipValue)
                       throws IOException
```
    Adds file attachment at document level.
    
    Parameters:
    
    description - the file description
    
    file - the path to the file.
    
    fileDisplay - the actual file name stored in the pdf
    
    mimeType - mime type of the file
    
    afRelationshipValue - if null, PdfName.Unspecified will be added. Shall be one of: PdfName.Source, PdfName.Data, PdfName.Alternative, PdfName.Supplement or PdfName.Unspecified.
    
    Throws:
    
    IOException
  - addFileAttachment
```
public void addFileAttachment(String description,
                              PdfFileSpec fs)
```
    Adds file attachment at document level.
    
    Parameters:
    
    description - the file description
    
    fs - PdfFileSpec object.
  - getPageLabels
```
public String[] getPageLabels()
```
    This method retrieves the page labels from a document as an array of String objects.
    
    Returns:
    
    String list of page labels if they were found, or null otherwise
  - hasOutlines
```
public boolean hasOutlines()
```
    Indicates if the document has any outlines
    
    Returns:
    
    true, if there are outlines and false otherwise.
  - setUserProperties
```
public void setUserProperties(boolean userProperties)
```
    Sets the flag indicating the presence of structure elements that contain user properties attributes.
    
    Parameters:
    
    userProperties - the user properties flag
  - setInitialDocumentId
```
@Deprecated
public void setInitialDocumentId(PdfString initialDocumentId)
```
    Deprecated. Will be removed in 7.1. Use WriterProperties.setInitialDocumentId(PdfString) instead
    
    The /ID entry of a document contains an array with two entries. The first one represents the initial document id. The second one should be the same entry, unless the document has been modified. iText will by default keep thi existing initial id. But if you'd like you can set this id yourself using this setter.
    
    Parameters:
    
    initialDocumentId - the new initial document id
  - setModifiedDocumentId
```
@Deprecated
public void setModifiedDocumentId(PdfString modifiedDocumentId)
```
    Deprecated. Will be removed in 7.1. Use WriterProperties.setModifiedDocumentId(PdfString) instead
    
    The /ID entry of a document contains an array with two entries. The first one represents the initial document id. The second one should be the same entry, unless the document has been modified. iText will by default generate a modified id. But if you'd like you can set this id yourself using this setter.
    
    Parameters:
    
    modifiedDocumentId - the new modified document id
  - getFont
```
public PdfFont getFont(PdfDictionary dictionary)
```
    Create a new instance of PdfFont or load already created one. Note, PdfFont which created with PdfFontFactory.createFont(PdfDictionary) won't be cached until it will be added to PdfCanvas or PdfResources.
  - getDefaultFont
```
public PdfFont getDefaultFont()
```
    Gets default font for the document: Helvetica, WinAnsi. One instance per document.
    
    Returns:
    
    instance of PdfFont or null on error.
  - addFont
```
public PdfFont addFont(PdfFont font)
```
    Adds a PdfFont instance to this document so that this font is flushed automatically on document close. As a side effect, the underlying font dictionary is made indirect if it wasn't the case yet
    
    Returns:
    
    the same PdfFont instance.
  - initTagStructureContext
```
protected void initTagStructureContext()
```
    Initialize TagStructureContext.
  - storeLinkAnnotation
```
protected void storeLinkAnnotation(PdfPage page,
                                   PdfLinkAnnotation annotation)
```
    Save the link annotation in a temporary storage for further copying.
    
    Parameters:
    
    page - just copied PdfPage link annotation belongs to.
    
    annotation - PdfLinkAnnotation itself.
  - checkIsoConformance
```
protected void checkIsoConformance()
```
    Checks whether PDF document conforms a specific standard. Shall be override.
  - markObjectAsMustBeFlushed
```
protected void markObjectAsMustBeFlushed(PdfObject pdfObject)
```
    Mark an object with PdfObject.MUST_BE_FLUSHED.
    
    Parameters:
    
    pdfObject - an object to mark.
  - flushObject
```
protected void flushObject(PdfObject pdfObject,
                           boolean canBeInObjStm)
                    throws IOException
```
    Flush an object.
    
    Parameters:
    
    pdfObject - object to flush.
    
    canBeInObjStm - indicates whether object can be placed into object stream.
    
    Throws:
    
    IOException - on error.
  - open
```
protected void open(PdfVersion newPdfVersion)
```
    Initializes document.
    
    Parameters:
    
    newPdfVersion - new pdf version of the resultant file if stamper is used and the version needs to be changed, or null otherwise
  - addCustomMetadataExtensions
```
protected void addCustomMetadataExtensions(XMPMeta xmpMeta)
```
    Adds custom XMP metadata extension. Useful for PDF/UA, ZUGFeRD, etc.
    
    Parameters:
    
    xmpMeta - XMPMeta to add custom metadata to.
  - updateXmpMetadata
```
protected void updateXmpMetadata()
```
    Updates XMP metadata. Shall be override.
  - updateDefaultXmpMetadata
```
protected XMPMeta updateDefaultXmpMetadata()
                                    throws XMPException
```
    Update XMP metadata values from PdfDocumentInfo.
    
    Throws:
    
    XMPException
  - getDocumentFonts
```
protected Collection<PdfFont> getDocumentFonts()
```
    List all newly added or loaded fonts
    
    Returns:
    
    List of PdfFont.
  - flushFonts
```
protected void flushFonts()
```
  - checkAndAddPage
```
protected void checkAndAddPage(int index,
                               PdfPage page)
```
    Checks page before adding and add.
    
    Parameters:
    
    index - one-base index of the page.
    
    page - PdfPage to add.
  - checkAndAddPage
```
protected void checkAndAddPage(PdfPage page)
```
    Checks page before adding.
    
    Parameters:
    
    page - PdfPage to add.
  - checkClosingStatus
```
protected void checkClosingStatus()
```
    checks whether a method is invoked at the closed document
  - getCounter
```
protected Counter getCounter()
```
    Gets Counter instance.
    
    Returns:
    
    Counter instance.

Class PdfDocument

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

currentPage

defaultPageSize

eventDispatcher

writer

reader

xmpMetadata

catalog

trailer

info

pdfVersion

initialDocumentId

modifiedDocumentId

properties

structTreeRoot

structParentIndex

userProperties

closeReader

closeWriter

isClosing

closed

flushUnusedObjects

tagStructureContext

Constructor Detail

PdfDocument

PdfDocument

PdfDocument

PdfDocument

Method Detail

setXmpMetadata

setXmpMetadata

setXmpMetadata

getXmpMetadata

getXmpMetadata

getPdfObject

getNumberOfPdfObjects

getPage

getPage

getFirstPage

getLastPage

addNewPage

addNewPage

addNewPage

addNewPage

addPage

addPage

getNumberOfPages

getPageNumber

getPageNumber

removePage

removePage

getDocumentInfo

getDefaultPageSize

setDefaultPageSize

addEventHandler

dispatchEvent

dispatchEvent

hasEventHandler

removeEventHandler

removeAllHandlers

getWriter

getReader

isAppendMode

createNextIndirectReference

getPdfVersion

getCatalog

close

isClosed

isTagged

setTagged

getStructTreeRoot

getNextStructParentIndex

getTagStructureContext

copyPagesTo

copyPagesTo