Convert Method

Summary

Converts the file associated with the PDFFile object to a different version using optional document properties and security options.

Syntax

C++/CLI

Java

Python

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

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

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

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

Parameters

firstPageNumber
The 1-based number of the first page to be converted. It must be a value greater than or equal to 1.

lastPageNumber
The 1-based number of the last page to be converted. It 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 the PDFFile object with a valid PDF file and optional password. Do 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 can be used to work on all or portion of the pages in a PDF file. To use all the pages of a document, pass 1 and -1 for firstPageNumber and lastPageNumber.

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 convert a PDF file to 1.5 and save it with new properties.

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 PDFFileConvertExample() 
{ 
   string sourceFileName = Path.Combine(LEAD_VARS.ImagesDir, @"Leadtools.pdf"); 
   string destinationFileName = Path.Combine(LEAD_VARS.ImagesDir, @"LEAD_15.pdf"); 
 
   PDFFile pdfFile = new PDFFile(sourceFileName); 
   pdfFile.DocumentProperties = new PDFDocumentProperties(); 
   PDFDocumentProperties properties = pdfFile.DocumentProperties; 
   properties.Author = "Me"; 
   properties.Creator = "My Application"; 
   properties.Title = "My Document"; 
   properties.Producer = "LEAD"; 
   properties.Subject = "My Subject"; 
   properties.Keywords = "Keyword1 Keyword2"; 
   properties.Created = DateTime.Now; 
   properties.Modified = DateTime.Now; 
 
   pdfFile.CompatibilityLevel = PDFCompatibilityLevel.PDF15; 
 
   pdfFile.Convert(1, -1, destinationFileName); 
} 
 
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 pdfFileConvertExample() { 
 
   final String LEAD_VARS_IMAGES_DIR = "C:\\LEADTOOLS23\\Resources\\Images"; 
   String sourceFileName = combine(LEAD_VARS_IMAGES_DIR, "Leadtools.pdf"); 
   String destinationFileName = combine(LEAD_VARS_IMAGES_DIR, "LEAD_15.pdf"); 
 
   PDFFile pdfFile = new PDFFile(sourceFileName); 
   PDFDocumentProperties dp = new PDFDocumentProperties(); 
   dp.setAuthor("Me"); 
   dp.setCreator("My Application"); 
   dp.setTitle("My Document"); 
   dp.setProducer("LEAD"); 
   dp.setSubject("My Subject"); 
   dp.setKeywords("Keyword1 Keyword2"); 
   dp.setCreated(new Date()); 
   dp.setModified(new Date()); 
   pdfFile.setDocumentProperties(dp); 
 
   pdfFile.setCompatibilityLevel(PDFCompatibilityLevel.PDF15); 
 
   pdfFile.convert(1, -1, destinationFileName); 
 
   PDFFile savedFile = new PDFFile(destinationFileName); 
   savedFile.load(); 
   assertTrue(savedFile.getDocumentProperties().getKeywords().equals("Keyword1 Keyword2")); 
}

Requirements

Target Platforms

Reference

PDFFile Class

PDFFile Members

Download our FREE evaluation

Help Version 23.0.2024.2.29

Leadtools.Pdf Assembly

Introduction

Getting Started

Namespaces

Leadtools.Pdf Namespace

Assemblies