PoDoFo  0.9.1
Public Member Functions
PoDoFo::PdfPagesTree Class Reference

#include <PdfPagesTree.h>

Inheritance diagram for PoDoFo::PdfPagesTree:
PoDoFo::PdfElement

List of all members.

Public Member Functions

 PdfPagesTree (PdfVecObjects *pParent)
 PdfPagesTree (PdfObject *pPagesRoot)
virtual ~PdfPagesTree ()
int GetTotalNumberOfPages () const
PdfPageGetPage (int nIndex)
PdfPageGetPage (const PdfReference &ref)
void InsertPage (int nAfterPageNumber, PdfObject *pPage)
void InsertPage (int nAfterPageNumber, PdfPage *pPage)
PdfPageCreatePage (const PdfRect &rSize)
void DeletePage (int inPageNumber)
void ClearCache ()

Detailed Description

Class for managing the tree of Pages in a PDF document Don't use this class directly. Use PdfDocument instead.

See also:
PdfDocument

Constructor & Destructor Documentation

Construct a new PdfPagesTree

Construct a PdfPagesTree from the root /Pages object

Parameters:
pPagesRootpointer to page tree dictionary

Close/down destruct a PdfPagesTree


Member Function Documentation

Clear internal cache of PdfPage objects. All references to PdfPage object will become invalid when calling this method. All PdfPages will be deleted.

You normally will never have to call this method. It is only useful if one modified the page nodes of the pagestree manually.

Creates a new page object and inserts it into the internal page tree. The returned page is owned by the pages tree and will get deleted along with it!

Parameters:
rSizea PdfRect specifying the size of the page (i.e the /MediaBox key) in PDF units
Returns:
a pointer to a PdfPage object
void PoDoFo::PdfPagesTree::DeletePage ( int  inPageNumber)

Delete the specified page object from the internal pages tree. It does NOT remove any PdfObjects from memory - just the reference from the tree

Parameters:
inPageNumberthe page number (0-based) to be removed

The PdfPage object refering to this page will be deleted by this call! Empty page nodes will also be deleted.

See also:
PdfMemDocument::DeletePages

Return a PdfPage for the specified Page index The returned page is owned by the pages tree and deleted along with it.

Parameters:
nIndexpage index, 0-based
Returns:
a pointer to the requested page

Return a PdfPage for the specified Page reference. The returned page is owned by the pages tree and deleted along with it.

Parameters:
refthe reference of the pages object
Returns:
a pointer to the requested page

Return the number of pages in the entire tree

Returns:
number of pages
void PoDoFo::PdfPagesTree::InsertPage ( int  nAfterPageNumber,
PdfObject pPage 
)

Inserts an existing page object into the internal page tree. after the specified page number

Parameters:
nAfterPageNumberan integer specifying after what page
  • may be one of the special values from EPdfPageInsertionPoint. Pages are 0 based.
pPagemusst be a PdfObject with type /Page
void PoDoFo::PdfPagesTree::InsertPage ( int  nAfterPageNumber,
PdfPage pPage 
)

Inserts an existing page object into the internal page tree. after the specified page number

Parameters:
nAfterPageNumberan integer specifying after what page
  • may be one of the special values from EPdfPageInsertionPoint. Pages are 0 based.
pPagea PdfPage to be inserted, the PdfPage will not get owned by the PdfPagesTree