←Select platform

ReplacePagesFrom Method

Summary
Replaces one or more pages from an existing PDF file into the file associated with this PDFFile object.
Syntax
C#
C++/CLI
Java
Python
public void ReplacePagesFrom( 
   int replacePageNumber, 
   PDFFile sourceFile, 
   int firstPageNumber, 
   int lastPageNumber 
) 
public void replacePagesFrom( 
   int replacePageNumber, 
   PDFFile sourceFile, 
   int firstPageNumber, 
   int lastPageNumber 
); 
public: 
void ReplacePagesFrom(  
   int replacePageNumber, 
   PDFFile^ sourceFile, 
   int firstPageNumber, 
   int lastPageNumber 
)  

Parameters

replacePageNumber
The 1-based number of the replacement point in this PDFFile object. Must be greater than or equal to 1 and less than or equal to the total number of pages in  sourceFile.

sourceFile
A PDFFile object associated with an existing PDF file that contain the source file to replace the pages from.

firstPageNumber
The 1-based number of the first page in the source file to be replaced. Must be a value greater than or equal to 1.

lastPageNumber
The 1-based number of the last page in the source file to be replaced. 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".

Remarks

Both files in this PDFFile (the destination) and  sourceFile must exist and contain valid PDF files prior to calling this method.

To use this method, associate this PDFFile object and the source PDFFile 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 this property is null, then default properties will be used

  • SecurityOptions. If the value of this property is not null, then the destination file will be encrypted using the properties of this property. If the value of this property is null, the result file will not be encrypted

  • CompatibilityLevel. The version of the generated PDF file

Example

This example will replace pages from an existing PDF file to another.

C#
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 PDFFileReplacePagesFromExample() 
{ 
   string originalFileName = Path.Combine(LEAD_VARS.ImagesDir, @"Leadtools.pdf"); 
   string sourceFileName = Path.Combine(LEAD_VARS.ImagesDir, @"PDFSegmentation.pdf"); 
 
   string destinationFileName = Path.Combine(LEAD_VARS.ImagesDir, @"LEAD_ReplacePage2.pdf"); 
 
   // Make a copy of the original file 
   File.Copy(originalFileName, destinationFileName, true); 
   File.SetAttributes(destinationFileName, FileAttributes.Normal); 
 
   // This is the source PDF file to replace with 
   PDFFile sourceFile = new PDFFile(sourceFileName); 
 
   // Replace page number 2 in destination file with source file 
   PDFFile file = new PDFFile(destinationFileName); 
   file.ReplacePagesFrom(2, sourceFile, 1, 1); 
} 
 
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 pdfFileReplacePagesFromExample() throws IOException { 
 
   final String LEAD_VARS_IMAGES_DIR = "C:\\LEADTOOLS23\\Resources\\Images"; 
   String originalFileName = combine(LEAD_VARS_IMAGES_DIR, "Leadtools.pdf"); 
   String sourceFileName = combine(LEAD_VARS_IMAGES_DIR, "PDFSegmentation.pdf"); 
   String destinationFileName = combine(LEAD_VARS_IMAGES_DIR, "LEAD_ReplacePage2.pdf"); 
 
   // Make a copy of the original file 
   Files.copy(Paths.get(originalFileName), Paths.get(destinationFileName), StandardCopyOption.REPLACE_EXISTING); 
 
   // This is the source PDF file to replace with 
   PDFFile sourceFile = new PDFFile(sourceFileName); 
 
   // Replace page number 2 in destination file with source file 
   PDFFile file = new PDFFile(destinationFileName); 
   file.replacePagesFrom(2, sourceFile, 1, 1); 
   assertTrue("Check that the file did not add any extra pages", 
         new PDFFile(destinationFileName).getPageCount() == 5); 
} 
Requirements

Target Platforms

See Also

Reference

PDFFile Class

PDFFile Members

Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Pdf Assembly
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.