PDFFilePage Structure

Summary

Contains information about a page in a PDF file.

Syntax

C++/CLI

Python

[SerializableAttribute()] 
public struct PDFFilePage

[SerializableAttribute()] 
public value class PDFFilePage : public System.ValueType

class PDFFilePage:

Remarks

The PDFFilePage structure is used as the type of the PDFFile.Pages collection.

To get the pages collection, populate a PDFFile object with the name of a valid PDF file and optional password and then use the PDFFile.Load method. When this returns, the PDFFile.Pages property will contain a list of PDFFilePage with each item corresponding to a page in the PDF file.

Each item in the PDFFile.Pages 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. Even though the PDFFilePage structure contains the PageNumber property that specifies the number of the page, this information is for convenience only, the PDFFile.Load will always populate the collection in the correct order from first page to last page.

The PDFFilePage structure contains the width and height of the page in PDF units which is read from the PDF file directly. PDF page units are in 1/72 of an inch, 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 PDFFile.Load to load the PDF file into the PDFFile object and use PDFFile.Pages.Count. Using the PDFFile.Load method will also read the size of each page as well as populating PDFFile.DocumentProperties with the properties of the file.
A faster way is to call PDFFile.GetPageCount directly. This method is faster than calling PDFFile.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.

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

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:\LEADTOOLS22\Resources\Images"; 
}

Requirements

Target Platforms

Reference

PDFFilePage Members

Leadtools.Pdf Namespace

PDF Coordinate System

Download our FREE evaluation

Help Version 22.0.2023.7.10

Leadtools.Pdf Assembly

Introduction

Getting Started

Namespaces

Leadtools.Pdf Namespace

Assemblies