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: an area in the global memory or a disk file. Later, the object can be re-created by reading the object's state from persistent storage. The following methods provide persistence of the object: SaveToFile, LoadFromFile, SaveToMemory, and LoadFromMemory.

Properties

Name Type Description
Application Engine, read-only Returns the Engine object.
Main settings
ExportFormat TXTExportFormatEnum

Specifies the format of export: TXT, CSV with full layout retained, or CSV with text from tables only.

By default, the value of the property is TEF_TXT, which means that export to TXT format is performed.

Format settings
ExportParagraphsAsOneLine VARIANT_BOOL

Specifies if each paragraph in the recognized text is exported as one line. This property is ignored if the LayoutRetentionMode property is set to a non-default value.

This property is FALSE by default.

InsertEmptyLineBetweenParagraphs VARIANT_BOOL

Specifies if an empty line should be inserted between paragraphs. This property is ignored if the LayoutRetentionMode property is set to a non-default value.

This property is FALSE by default.

LayoutRetentionMode TextLayoutRetentionModeEnum

Manages the settings of layout emulation during export to TXT format.

The default value of this property is TXTLRM_Auto.

RetainLayout VARIANT_BOOL

This property is deprecated and will be deleted in future versions. To simulate the original layout with the help of spaces, set the LayoutRetentionMode property to TXTLRM_ExactCopy.

This property is FALSE by default.

UsePageBreaks VARIANT_BOOL

Specifies if page break symbols (0x12) will be inserted between pages when multiple pages are exported into TXT or CSV format.

This property is FALSE by default.

AppendToEnd VARIANT_BOOL

Specifies if exported text is appended at the end of file if it already exists.

This property is FALSE by default.

WriteBomCharacter VARIANT_BOOL

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.

This property is TRUE by default.

WriteRunningTitles VARIANT_BOOL

Specifies whether the running titles should be saved to an output TXT file.

This property is TRUE by default.

TabSeparator BSTR

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.

By default, the value of the table separator is "\t".

Encoding
EncodingType TextEncodingTypeEnum

Specifies the encoding type of the output file in TXT or CSV format.

This property is TET_Auto by default. This means that encoding is selected in the following way:

CodePage CodePageEnum

This property specifies the code page to which the recognized text is exported.

The value of this property is taken into account only when the EncodingType property has value TET_Simple (exported text is not Unicode). If this property does not specify any code page (CP_Null), the code page is selected automatically.

By default, this property is CP_Null.

Methods

Name Description
CopyFrom Initializes properties of the current object with values of similar properties of another object.
LoadFromFile Restores the object contents from a file on disk.
LoadFromMemory Restores the object contents from the global memory.
SaveToFile Saves the object contents into a file on disk.
SaveToMemory Saves the object contents into the global memory.

Output parameter

This object is the output parameter of the CreateTextExportParams method of the Engine object.

Input parameter

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

Samples

The object is used in the following code samples: CommandLineInterface.

See also

Tuning Export Parameters

Working with Profiles

Working with Properties

24.03.2023 8:51:52

Usage of Cookies. In order to optimize the website functionality and improve your online experience ABBYY uses cookies. You agree to the usage of cookies when you continue using this site. Further details can be found in our Privacy Notice.