PDFDocument Class

Summary

Encapsulates a PDF document and allows PDF pages, objects, and images to be read.

Syntax

C++

Java

public class PDFDocument : IDisposable

Public Class PDFDocument

public class PDFDocument

public ref class PDFDocument

Remarks

The PDFDocument class encapsulates a PDF document on disk and allows you to read the pages, objects, and images from the document. Use the PDFDocument class to perform the following tasks:

Create a PDF document from a PDF file on disk or stream (with support for reading encrypted documents) using the PDFDocument(string fileName), PDFDocument(Stream stream), PDFDocument(string fileName, string password) and PDFDocument(Stream stream, string password) constructors.
Load the PDF document at any resolution (dots per inch) using the Resolution property.
Get information about the PDF document. This encompasses properties or metadata such as author, subject, and keywords through the DocumentProperties property; the security and encryption options to use with the PDF document through the SecurityOptions property; whether it is encrypted and requires a password to read (using the IsEncrypted property); and the PDF file type (or version), using the FileType property.
Call ParseDocumentStructure to parse the document structure (Table of Contents or TOC) of the PDF document. The TOC is a list of PDF bookmark objects stored in the Bookmarks property, along with the internal links between pages (or jumps) found in the document stored in the InternalLinks property. This method can also parse the embedded files (attachments) found in the PDF.
Automatically create a list of PDFDocumentPage objects and store them in the Pages property. This makes it possible to get information about any page in the PDF document (that is, its size in PDF units, inches, or pixels).
Use ParsePages to parse the objects of a range of pages (or all pages) in the document. ParsePages can read the text items (characters), images, rectangles, hyperlinks, annotations, form fields, digital signatures, and fonts found in the pages of the documents.
Use GetPageImage to get a Leadtools.RasterImage rendering of one or more pages from the PDF document at any resolution. Call GetThumbnail to get a thumbnail of any page in the document.
Use GetPageSvg to get a Leadtools.ISvgDocument representation of one or more pages of the PDF document.

To create a PDFDocument from a PDF file on disk or stream, use the PDFDocument(string fileName)/PDFDocument(Stream stream) constructors, passing the file name or stream reference. If the document is encrypted with a password, then use the PDFDocument(string fileName, string password)/PDFDocument(Stream stream, string password) constructors, which will automatically decrypt the document and read it. To find out whether a document is encrypted and requires a password, call the static PDFFile.IsEncrypted method.

Because the PDFDocument class implements the System.IDisposable interface, it is best to follow the standard .NET dispose pattern when using it. For more information, refer to the System.IDisposable interface documentation in MSDN.

NOTE: The PDFDocument class is only included as part of the LEADTOOLS PDF Advanced support (PDF Read, Write, Edit, and Compress) unlocked by your license. If you receive a "PDF Capability Required" error, please verify that your license unlocks PDF Advanced support. For information on which LEADTOOLS products include this support, see the LEADTOOLS Product Comparison Chart.

Example

This example will create a PDFDocument object from a PDF file on disk and then display its properties.

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Controls; 
using Leadtools.Pdf; 
using Leadtools.Svg; 
using Leadtools.WinForms; 
 
public void PDFDocumentExample() 
{ 
   string pdfFileName = Path.Combine(LEAD_VARS.ImagesDir, @"Leadtools.pdf"); 
 
   // Create a PDF document for file 
   using (PDFDocument document = new PDFDocument(pdfFileName)) 
   { 
 
      // Show the file type and properties 
      Console.WriteLine("File type is : {0}", document.FileType); 
      Console.WriteLine("Contains : {0} pages", document.Pages.Count); 
      Console.WriteLine("----------:"); 
      foreach (PDFDocumentPage page in document.Pages) 
      { 
         Console.WriteLine("Page: {0}, size: {1} by {2} ({3} by {4} inches)", page.PageNumber, page.Width, page.Height, page.WidthInches, page.HeightInches); 
      } 
 
      PDFDocumentProperties props = document.DocumentProperties; 
      Console.WriteLine("Properties:"); 
      Console.WriteLine("----------:"); 
      Console.WriteLine("Title: {0}", props.Title); 
      Console.WriteLine("Author: {0}", props.Author); 
      Console.WriteLine("Subject: {0}", props.Subject); 
      Console.WriteLine("Keywords: {0}", props.Keywords); 
      Console.WriteLine("Creator: {0}", props.Creator); 
      Console.WriteLine("Producer: {0}", props.Producer); 
      Console.WriteLine("Created: {0}", props.Created); 
      Console.WriteLine("Modified: {0}", props.Modified); 
   } 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images"; 
}

Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.Controls 
Imports Leadtools.Pdf 
Imports Leadtools.Svg 
Imports Leadtools.WinForms 
 
Public Sub PDFDocumentExample() 
   Dim pdfFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "Leadtools.pdf") 
 
   ' Create a PDF document for file 
   Using document As PDFDocument = New PDFDocument(pdfFileName) 
 
      ' Show the file type and properties 
      Console.WriteLine("File type is : {0}", document.FileType) 
      Console.WriteLine("Contains : {0} pages", document.Pages.Count) 
      Console.WriteLine("----------:") 
      For Each page As PDFDocumentPage In document.Pages 
         Console.WriteLine("Page: {0}, size: {1} by {2} ({3} by {4} inches)", page.PageNumber, page.Width, page.Height, page.WidthInches, page.HeightInches) 
      Next page 
 
      Dim props As PDFDocumentProperties = document.DocumentProperties 
      Console.WriteLine("Properties:") 
      Console.WriteLine("----------:") 
      Console.WriteLine("Title: {0}", props.Title) 
      Console.WriteLine("Author: {0}", props.Author) 
      Console.WriteLine("Subject: {0}", props.Subject) 
      Console.WriteLine("Keywords: {0}", props.Keywords) 
      Console.WriteLine("Creator: {0}", props.Creator) 
      Console.WriteLine("Producer: {0}", props.Producer) 
      Console.WriteLine("Created: {0}", props.Created) 
      Console.WriteLine("Modified: {0}", props.Modified) 
   End Using 
End Sub 
 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images" 
End Class