ExtractPages(int,int,string) Method

Summary

Extract one or more pages from the file associated with this PDFFile object using a range of page numbers.

Syntax

C++/CLI

Java

Python

public void ExtractPages( 
   int firstPageNumber, 
   int lastPageNumber, 
   string destinationFileName 
)

public void extractPages( 
   int intValue,  
   int intValue2,  
   java.lang.String string 
);

public: 
void ExtractPages(  
   int firstPageNumber, 
   int lastPageNumber, 
   String^ destinationFileName 
)

def ExtractPages(self,firstPageNumber,lastPageNumber,destinationFileName):

Parameters

firstPageNumber

The 1-based number of the first page to be extracted. Must be a value greater than or equal to 1.

lastPageNumber

The 1-based number of the last page to be extracted. Must be a value greater than or equal to firstPageNumber and less than or equal to the total number of pages in the file. Use the special value of -1 to represent "last page in the file".

destinationFileName

Name of the destination PDF file to be created. If the value of this parameter is null, then the filename set in FileName will be updated.

Remarks

To use this method, associate this PDFFile object with a valid PDF file and optional password. You can achieve this by either using the PDFFile(string fileName) or PDFFile(string fileName, string password) constructors or set the filename and optional password directly into the FileName and Password properties. You do not need to call Load before using this method.

This method will use the following properties of this PDFFile object:

DocumentProperties. If the value of DocumentProperties is null, then the default properties will be used.
SecurityOptions. If the value of SecurityOptions property is not null, then the destination file will be encrypted using the SecurityOptions properties. If the value of SecurityOptions property is null, then the resulting file will not be encrypted.
CompatibilityLevel. The version of the generated PDF file.

You can also pass the source pages as an array by using the PDFFile.ExtractPages(int[] pages, string destinationFileName) method. Additionally, you can combine pages from one or more files into a single output file using the PDFFile.MergeFiles method.

Example

using Leadtools.WinForms; 
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Controls; 
using Leadtools.Drawing; 
using Leadtools.ImageProcessing; 
using Leadtools.Pdf; 
using Leadtools.Svg; 
 
 
/// This example will extract the pages a multi-page PDF file. 
public void PDFFileExtractPagesExample() 
{ 
   string sourceFileName = Path.Combine(LEAD_VARS.ImagesDir, @"Leadtools.pdf"); 
 
   // Get the number of pages in the source file 
   PDFFile file = new PDFFile(sourceFileName); 
   int pageCount = file.GetPageCount(); 
   Console.WriteLine("Pages in source file : {0}", pageCount); 
 
   // Extract each page to an individual PDF file 
   for (int i = 1; i <= pageCount; i++) 
   { 
      string destinationFileName = Path.Combine(LEAD_VARS.ImagesDir, string.Format("LEAD_Page{0}.pdf", i)); 
      file.ExtractPages(i, i, destinationFileName); 
   } 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS22\Resources\Images"; 
}

Requirements

Target Platforms