Pages Property

Summary

Gets the collection of pages in this PDF file.

Syntax

C++/CLI

Java

Python

public IList<PDFFilePage> Pages { get; }

public java.util.List<PDFFilePage> getPages();

public: 
property IList<PDFFilePage>^ Pages { 
   IList<PDFFilePage>^ get(); 
}

Pages # get  (PDFFile)

Property Value

A collection of PDFFilePage objects that contain an item for each page in the PDF file associated with this PDFFile object. Default value is null.

Remarks

The value of Pages will be populated with the pages collection after you set a valid PDF filename (and optional password) in this PDFFile object and call the Load method.

Each item in the collection corresponds to a page in the PDF file. So item at index 0 is the properties of page 1, item at index 1 is the properties of page 2 and so on.

The PDFFilePage structure contains the width and height of the page in PDF units which is read from the PDF file directly. PDF units are in 1/72 of an inch units, so a page size of 612 by 792 corresponds to 8.5 by 11 inches (612/72 by 792/72). For more information, refer to PDF Coordinate System.

You can get the total number of pages in a PDF file with two ways:

Use Load to load the PDF file into the PDFFile object and use PDFFile.Pages.Count. Using the Load method will also read the size of each page as well as populating the DocumentProperties with the properties of the file.
A faster way is to call GetPageCount directly. This method is faster than calling Load since it will not parse the page sizes nor the document properties. Just set the filename and optional password and call the method.

The values of the PDFFilePage structure are used as read only by the PDFFile object. The toolkit will only return objects of type PDFFilePage from the PDF document and does not use them anymore.

The PDFFilePage does not contain any information about a PDF page other than its size. To get the objects, bookmarks, images, links of a page, use the PDFDocument class and its collection of PDFDocumentPage items.

Example

This example will show the size of each page in a PDF file.

Java

using Leadtools.WinForms; 
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Controls; 
using Leadtools.Drawing; 
using Leadtools.ImageProcessing; 
using Leadtools.Pdf; 
using Leadtools.Svg; 
 
 
public void PDFFilePagesExample() 
{ 
   string pdfFileName = Path.Combine(LEAD_VARS.ImagesDir, @"Leadtools.pdf"); 
 
   // Load the file 
   PDFFile file = new PDFFile(pdfFileName); 
   file.Load(); 
 
   // Show the pages 
   Console.WriteLine("File has {0} pages", file.Pages.Count); 
   foreach (PDFFilePage page in file.Pages) 
   { 
      Console.WriteLine("Page {0} size is {1} by {2} units", page.PageNumber, page.Width, page.Height); 
   } 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
}

 
import java.io.ByteArrayInputStream; 
import java.io.File; 
import java.io.FileInputStream; 
import java.io.FileNotFoundException; 
import java.io.FileOutputStream; 
import java.io.FileReader; 
import java.io.IOException; 
import java.io.InputStream; 
import java.nio.file.Files; 
import java.nio.file.Paths; 
import java.nio.file.StandardCopyOption; 
import java.util.ArrayList; 
import java.util.Date; 
import java.util.List; 
import java.util.Scanner; 
 
import org.junit.*; 
import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 
import static org.junit.Assert.*; 
 
import leadtools.*; 
import leadtools.codecs.*; 
import leadtools.pdf.*; 
 
 
public void pdfFilePagesExample() { 
 
   final String LEAD_VARS_IMAGES_DIR = "C:\\LEADTOOLS23\\Resources\\Images"; 
   String pdfFileName = combine(LEAD_VARS_IMAGES_DIR, "Leadtools.pdf"); 
 
   // Load the file 
   PDFFile file = new PDFFile(pdfFileName); 
   file.load(); 
 
   // Show the pages 
   System.out.printf("File has %d pages%n", file.getPageCount()); 
   for (PDFFilePage page : file.getPages()) { 
      System.out.printf("Page %d size is %f by %f units%n", page.getPageNumber(), page.getWidth(), page.getHeight()); 
   } 
   assertTrue(file.getPages().size() == 5); 
 
}

Requirements

Target Platforms

Reference

PDFFile Class

PDFFile Members

PDF Coordinate System

Download our FREE evaluation

Help Version 23.0.2024.2.29

Leadtools.Pdf Assembly

Introduction

Getting Started

Namespaces

Leadtools.Pdf Namespace

Assemblies