←Select platform

PrepareToSave Method

Summary

Prepares this document for saving.

Syntax
C#
VB
C++
public void PrepareToSave() 
Public Sub PrepareToSave() 
public:  
   void PrepareToSave() 

Remarks

This method must be called before the LEADDocument currently in the viewer is saved or passed to a DocumentConverter instance for conversion to a new format.

The method will update all the data that might have been changed by the user including the text or annotations containers.

Example

Start with the example created in DocumentViewerAnnotations, remove all the code in the Example function and add the code below.

When the user clicks the Example button, the document is saved to a new PDF file.

C#
VB
using Leadtools; 
using Leadtools.Controls; 
using Leadtools.Document; 
using Leadtools.Document.Viewer; 
using Leadtools.Document.Converter; 
using Leadtools.Codecs; 
using Leadtools.Caching; 
using Leadtools.Annotations.Engine; 
using Leadtools.Annotations.Automation; 
using Leadtools.Annotations.WinForms; 
using Leadtools.Annotations.Designers; 
using Leadtools.Document.Writer; 
using Leadtools.Ocr; 
 
// Ask for output file name 
string outputFileName = null; 
using (var dlg = new SaveFileDialog()) 
{ 
   dlg.Filter = "PDF Files|*.pdf;|All Files|*.*"; 
   if (dlg.ShowDialog() != DialogResult.OK) 
      return; 
   outputFileName = dlg.FileName; 
} 
 
// Before we save, we must save any data being cached such as the annotations 
_documentViewer.PrepareToSave(); 
 
// If we have an OCR engine, use it 
// Ready, use Document Converter to save the document with its annotations 
var converter = new DocumentConverter(); 
// If we have an OCR engine, use it 
if (_ocrEngine != null) 
   converter.SetOcrEngineInstance(_ocrEngine, false); 
 
var jobData = DocumentConverterJobs.CreateJobData( 
   _documentViewer.Document, 
   outputFileName, 
   DocumentFormat.Pdf); 
// Embed the annotations 
jobData.AnnotationsMode = DocumentConverterAnnotationsMode.Embed; 
 
// Create the job 
var job = converter.Jobs.CreateJob(jobData); 
 
// Run it 
converter.Jobs.RunJob(job); 
 
if (job.Status != DocumentConverterJobStatus.Aborted) 
{ 
   MessageBox.Show("Document created successfully"); 
   System.Diagnostics.Process.Start(outputFileName); 
} 
Imports Leadtools 
Imports Leadtools.Controls 
Imports Leadtools.Document 
Imports Leadtools.Document.Viewer 
Imports Leadtools.Document.Converter 
Imports Leadtools.Codecs 
Imports Leadtools.Caching 
Imports Leadtools.Annotations.Engine 
Imports Leadtools.Annotations.Automation 
Imports Leadtools.Annotations.WinForms 
Imports Leadtools.Annotations.Designers 
Imports Leadtools.Document.Writer 
Imports Leadtools.Ocr 
 
' Ask for output file name 
Dim outputFileName As String = Nothing 
Using dlg As New SaveFileDialog() 
   dlg.Filter = "PDF Files|*.pdf;|All Files|*.*" 
   If dlg.ShowDialog() <> DialogResult.OK Then Return 
   outputFileName = dlg.FileName 
End Using 
 
' Before we save, we must save any data being cached such as the annotations 
_documentViewer.PrepareToSave() 
 
' If we have an OCR engine, use it 
' Ready, use Document Converter to save the document with its annotations 
Dim converter As New DocumentConverter() 
' If we have an OCR engine, use it 
If Not IsNothing(_ocrEngine) Then 
   converter.SetOcrEngineInstance(_ocrEngine, False) 
End If 
 
Dim jobData As DocumentConverterJobData = DocumentConverterJobs.CreateJobData( 
   _documentViewer.Document, 
   outputFileName, 
   DocumentFormat.Pdf) 
' Embed the annotations 
jobData.AnnotationsMode = DocumentConverterAnnotationsMode.Embed 
 
' Create the job 
Dim job As DocumentConverterJob = converter.Jobs.CreateJob(jobData) 
 
' Run it 
converter.Jobs.RunJob(job) 
 
If job.Status <> DocumentConverterJobStatus.Aborted Then 
   MessageBox.Show("Document created successfully") 
   System.Diagnostics.Process.Start(outputFileName) 
End If 

Requirements

Target Platforms

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

Leadtools.Document.Viewer.WinForms Assembly