> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TextExportParams Object (ITextExportParams Interface)

This object provides functionality for tuning parameters of recognized text export in TXT or CSV format by means of ABBYY FineReader Engine export functions. To select the format of export, use the ExportFormat property. In CSV the following formatting applies:

* Original lines are retained
* Lines containing separator symbols are quoted(" ")
* Quotes inside other quotes are duplicated

A pointer to this object is passed into the export methods as an input parameter, and thus affects the results of export. All properties of a newly created object of this type are set to reasonable defaults. For more information about the default value of this or that property, see the description of the corresponding property.

The TextExportParams object is a persistent object. This means that the object's current state can be written to persistent storage. Later, the object can be re-created by reading the object's state from the persistent storage. The following methods provide persistence of the object:

Linux: [SaveToFile](/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method), and [LoadFromFile](/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)

Windows [SaveToFile](/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method), [LoadFromFile](/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method), [SaveToMemory](/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method), and [LoadFromMemory](/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method).

## Properties

<table><thead><tr><th><p><strong>Name</strong></p></th><th><p><strong>Type</strong></p></th><th><p><strong>Description</strong></p></th></tr></thead><tbody><tr><td><p><strong>Application</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/engine-object-iengine-interface">Engine</a></strong>, <a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">read-only</a></p></td><td><p>Returns the <strong>Engine</strong> object.</p></td></tr><tr><td colspan="3"><p><em>Main settings</em></p></td></tr><tr><td><p><a name="exportformat" /><strong>ExportFormat</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/enumerations/txtexportformatenum">TXTExportFormatEnum</a></strong></p></td><td><p>Specifies the format of export: TXT, CSV with full layout retained, or CSV with text from tables only.</p><p>By default, the value of the property is TEF\_TXT, which means that export to TXT format is performed.</p></td></tr><tr><td colspan="3"><p><em>Format settings</em></p></td></tr><tr><td><p><a name="exportparagraphsasoneline" /><strong>ExportParagraphsAsOneLine</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">VARIANT\_BOOL</a></strong></p></td><td><p>Specifies if each paragraph in the recognized text is exported as one line. This property is ignored if the <strong>LayoutRetentionMode</strong> property is set to a non-default value.</p><p>This property is FALSE by default.</p></td></tr><tr><td><p><a name="insertemptylinebetweenparagraphs" /><strong>InsertEmptyLineBetweenParagraphs</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">VARIANT\_BOOL</a></strong></p></td><td><p>Specifies if an empty line should be inserted between paragraphs. This property is ignored if the <strong>LayoutRetentionMode</strong> property is set to a non-default value.</p><p>This property is FALSE by default.</p></td></tr><tr><td><p><a name="layoutretentionmode" /><strong>LayoutRetentionMode</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/enumerations/textlayoutretentionmodeenum">TextLayoutRetentionModeEnum</a></strong></p></td><td><p>Manages the settings of layout emulation during export to TXT format.</p><p>The default value of this property is TXTLRM\_Auto.</p></td></tr><tr><td><p><a name="retainlayout" /><strong>RetainLayout</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">VARIANT\_BOOL</a></strong></p></td><td><p>This property is deprecated and will be deleted in future versions. To simulate the original layout with the help of spaces, set the <strong>LayoutRetentionMode</strong> property to TXTLRM\_ExactCopy.</p><p>This property is FALSE by default.</p></td></tr><tr><td><p><strong>UsePageBreaks</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">VARIANT\_BOOL</a></strong></p></td><td><p>Specifies if page break symbols (0x12) will be inserted between pages when multiple pages are exported into TXT or CSV format.</p><p>This property is FALSE by default.</p></td></tr><tr><td><p><strong>AppendToEnd</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">VARIANT\_BOOL</a></strong></p></td><td><p>Specifies if exported text is appended at the end of file if it already exists.</p><p>This property is FALSE by default.</p></td></tr><tr><td><p><a name="writebomcharacter" /><strong>WriteBomCharacter</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">VARIANT\_BOOL</a></strong></p></td><td><p>Specifies whether the byte order mark (BOM) should appear at the start of the text stream when the document is exported to TXT format in UTF-8 encoding.</p><p>This property is TRUE by default.</p></td></tr><tr><td><p><a name="writerunningtitles" /><strong>WriteRunningTitles</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">VARIANT\_BOOL</a></strong></p></td><td><p>Specifies whether the running titles should be saved to an output TXT file.</p><p>This property is TRUE by default.</p></td></tr><tr><td><p><strong>TabSeparator</strong></p></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">BSTR</a></strong></p></td><td><p>Stores the string with which the table separators are replaced in the exported text. This property is taken into account during export to CSV and TXT formats.</p><p>By default, the value of the table separator is "\t".</p></td></tr><tr><td colspan="3"><p><em>Encoding</em></p></td></tr><tr><td><p><a name="encodingtype" /><strong>EncodingType</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/enumerations/textencodingtypeenum">TextEncodingTypeEnum</a></strong></p></td><td><p>Specifies the encoding type of the output file in TXT or CSV format.</p><p>This property is TET\_Auto by default. This means that encoding is selected in the following way:</p><ul><li>when the export format is specified by the <strong><a href="/fine-reader/engine/api-reference/enumerations/fileexportformatenum#fef_textversion10defaults">FEF\_TextVersion10Defaults</a></strong> constant, this property resolves into TET\_Simple;</li><li>when the export format is specified by the <strong><a href="/fine-reader/engine/api-reference/enumerations/fileexportformatenum#fef_textunicodedefaults">FEF\_TextUnicodeDefaults</a></strong> constant, this property resolves into TET\_UTF8.</li></ul></td></tr><tr><td><p><a name="codepage" /><strong>CodePage</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/enumerations/codepageenum">CodePageEnum</a></strong></p></td><td><p>This property specifies the code page to which the recognized text is exported.</p><p>The value of this property is taken into account only when the <strong>EncodingType</strong> property has value TET\_Simple<strong> </strong>(exported text is not Unicode). If this property does not specify any code page (CP\_Null), the code page is selected automatically.</p><p>By default, this property is CP\_Null.</p></td></tr></tbody></table>

## Methods

| Name                                                                                                                                               | Description                                                                                       |
| -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| [CopyFrom](/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method)                              | Initializes properties of the current object with values of similar properties of another object. |
| [LoadFromFile](/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method)                                            | Restores the object contents from a file on disk.                                                 |
| [LoadFromMemory](/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method) <br /><br /> **Note:** *Windows only.* | Restores the object contents from the global memory.                                              |
| [SaveToFile](/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method)                                                | Saves the object contents into a file on disk.                                                    |
| [SaveToMemory](/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) <br /><br /> **Note:** *Windows only.*     | Saves the object contents into the global memory.                                                 |

## Output parameter

This object is the output parameter of the [CreateTextExportParams](/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) method of the [Engine](/fine-reader/engine/api-reference/engine-object-iengine-interface) object.

## Input parameter

This object is passed as the input parameter to the following methods:

* [Export](/fine-reader/engine/api-reference/document-related-objects/frdocument/export-method), [ExportPages](/fine-reader/engine/api-reference/document-related-objects/frdocument/exportpages-method), [ExportToMemory](/fine-reader/engine/api-reference/document-related-objects/frdocument/exporttomemory-method) methods of the [FRDocument](/fine-reader/engine/api-reference/document-related-objects/frdocument) object

* [Export](/fine-reader/engine/api-reference/document-related-objects/frpage/export-method) method of the [FRPage](/fine-reader/engine/api-reference/document-related-objects/frpage) object

* [RecognizeImageFile](/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/recognizeimagefile-method) method of the [Engine](/fine-reader/engine/api-reference/engine-object-iengine-interface) object

* [OnExportPages](/fine-reader/engine/visual-components-reference/idocumentviewerevents/onexportpages-method) method of the [IDocumentViewerEvents](/fine-reader/engine/visual-components-reference/idocumentviewerevents) interface for Windows Visual Components

* [OnSendToPages](/fine-reader/engine/visual-components-reference/idocumentviewerevents/onsendtopages-method) method of the [IDocumentViewerEvents](/fine-reader/engine/visual-components-reference/idocumentviewerevents) interface for Windows Visual Components

## Samples

The object is used in the following code samples: [CommandLineInterface](/fine-reader/engine/guided-tour/samples#commandlineinterface) (Windows and Linux)

## See also

[Tuning Export Parameters](/fine-reader/engine/guided-tour/advanced-techniques/tuning-export-parameters)

[Working with Profiles](/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles)

[Working with Properties](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)