[SerializableAttribute()]
[DataContractAttribute()]
public enum DocumentFormat
Value | Member | Description |
---|---|---|
-1 | User | User-defined document format. The User document format is not used inside the LEADTOOLS Document Writers toolkit. An exception will be thrown if User is used as an output document format in the DocumentWriter.BeginDocument method. The User format can however be used as an output format when used in the LEADTOOLS OCR toolkit as a special case to instruct the OCR framework to save the document using the engine native format. |
0 | Ltd | LEADTOOLS Temporary Document. This format creates a temporary file on disk that can later be converted to any of the other formats supported by the LEADTOOLS Document Writers.This format supports appending pages to an existing file, therefore, you can use the Ltd format if you have large amount of pages to convert over multiple sessions. When calling the DocumentWriter.BeginDocument method with the Ltd document format, the toolkit will check if the output file specified exists on disk. If it does, the new pages will be appended to the end of the file. When you are finished adding all the pages use the DocumentWriter.Convert method to convert this temporary file to the desired output format. |
1 | Adobe Portable Document Format (PDF).LEADTOOLS Document Writers support several flavors with multiple options of the PDF format, for more information refer to PdfDocumentOptions. Note: The PDF document support requires unlocking an extra key before it can be used. For more information, refer to RasterSupportType and Unlocking Special LEAD Features. | |
2 | Doc | Microsoft Word 2003 document format (DOC).LEADTOOLS Document Writers support extra options for the DOC format. For more information refer to DocDocumentOptions. |
3 | Rtf | Rich Text Format (RTF).LEADTOOLS Document Writers support extra options for the RTF format. For more information refer to RtfDocumentOptions. |
4 | Html | HyperText Markup Language (HTML).LEADTOOLS Document Writers support several flavors with multiple options of the HTML format. For more information refer to HtmlDocumentOptions. |
5 | Text | Text format.LEADTOOLS Document Writers support extra options for the Text format. For more information refer to TextDocumentOptions. |
6 | Emf | Windows Enhanced Meta File (EMF).EMF format does not support multipage documents. Therefore, only the last page added with DocumentWriter.AddPage or DocumentWriter.InsertPage will be used in the final document. |
7 | Xps | Microsoft Open XML Paper Specification (XPS) (this format requires .NET Framework 3.0 or later).LEADTOOLS Document Writers support extra options for the XPS format. For more information refer to XpsDocumentOptions. |
8 | Docx | Microsoft Word Document format (DOCX) (this format requires .NET Framework 3.0 or later and Microsoft Open XML Format SDK 2.*.).The DOCX format is part of Microsoft Open XML specification and first introduced with Microsoft Office 2007.LEADTOOLS Document Writers support extra options for the DOCX format. For more information refer to DocxDocumentOptions. |
9 | Xls | Microsoft Excel 2003 format (XLS).LEADTOOLS Document Writers support extra options for the XLS format. For more information refer to XlsDocumentOptions. |
10 | Pub | eBooks format (ePUB).LEADTOOLS Document Writers support extra options for the ePUB format. For more information refer to PubDocumentOptions. |
11 | Mob | Mobipocket e-book format (MOB).LEADTOOLS Document Writers support extra options for the MOB format. For more information refer to MobDocumentOptions. |
12 | Svg | Scalable Vector Graphics format (SVG).SVG format does not support multipage documents. Therefore, only the last page added with the AddPage will be used in the final document.For more information refer to SvgDocumentOptions. |
13 | AltoXml | ALTO (Analyzed Layout and Text Object) is an XML Schema used by the library of congress to describe OCR text and layout format.LEADTOOLS Document Writers support extra options for the ALTO format. LEADTOOLS supports ALTO XML version 1 using UTF-8 encoding. For more information refer to AltoXmlDocumentOptions. |
14 | Xlsx | Microsoft Open XML Spreadsheet (XLSX). |
The DocumentFormat enumeration specifies the output format for the final document created with the LEADTOOLS Document Writers. Pass the format that are desired to the DocumentWriter.BeginDocument method.
To get or set the extra options supported by a format, use the DocumentWriter.GetOptions and DocumentWriter.SetOptions methods.
Some of the document formats require a special key to unlock. When using these formats unlock the specified support using the RasterSupport class first.
The following table lists the document formats and the support type required to be unlocked before using them:
Document Format | Support Type |
---|---|
Doc, Docx, Emf, Html, Ltd, Rtf, Text, Pup, Mob, AltoXml, Svg, User and Xls. | RasterSupportType.DocumentWriters |
Pdf and Xps | RasterSupportType.DocumentWriters and RasterSupportType.DocumentWritersPdf |
Note: Not all formats are supported in all platforms. Use DocumentWriter.GetSupportedFormats to find the current level of support.
using Leadtools;
using Leadtools.Codecs;
using Leadtools.Document.Writer;
using Leadtools.Ocr;
public void DocumentWriterExample()
{
var inputFileName = Path.Combine(LEAD_VARS.ImagesDir, "test.docx");
var outputFileName = Path.Combine(LEAD_VARS.ImagesDir, "Example.pdf");
// Setup a new RasterCodecs object
var codecs = new RasterCodecs();
codecs.Options.RasterizeDocument.Load.Resolution = 300;
// Get the number of pages in the input document
var pageCount = codecs.GetTotalPages(inputFileName);
// Create a new instance of the LEADTOOLS Document Writer
var docWriter = new DocumentWriter();
// Change the PDF options
var pdfOptions = docWriter.GetOptions(DocumentFormat.Pdf) as PdfDocumentOptions;
pdfOptions.DocumentType = PdfDocumentType.PdfA;
docWriter.SetOptions(DocumentFormat.Pdf, pdfOptions);
// Create a new PDF document
Debug.WriteLine("Creating new PDF document: {0}", outputFileName);
docWriter.BeginDocument(outputFileName, DocumentFormat.Pdf);
// Loop through all the pages
for (var pageNumber = 1; pageNumber <= pageCount; pageNumber++)
{
// Get the page as SVG
Debug.WriteLine("Loading page {0}", pageNumber);
var page = new DocumentWriterSvgPage();
page.SvgDocument = codecs.LoadSvg(inputFileName, pageNumber, null);
// Add the page
Debug.WriteLine("Adding page {0}", pageNumber);
docWriter.AddPage(page);
page.SvgDocument.Dispose();
}
// Finally finish writing the PDF file on disk
docWriter.EndDocument();
codecs.Dispose();
}
static class LEAD_VARS
{
public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images";
}