Export Method of the FRPage Object
This method saves page into a file in an external format. Available file formats are represented by the FileExportFormatEnum enumeration constants.
Syntax
HRESULT Export( BSTR ExportFileName, FileExportFormatEnum Format, IUnknown* ExportParams );
Parameters
- ExportFileName
- [in] This variable contains the full path to the output file. If this file already exists, it is overwritten without prompt.
- Format
- [in] This variable specifies the format of the output file. See the FileExportFormatEnum description for the supported file formats.
- ExportParams
- [in] Pass the export parameters object of the type corresponding to your file format through this input parameter. For example, if you are saving the text into an RTF file, create an RTFExportParams object, set the necessary parameters in it, and pass it to this method as the exportParams input parameter. This parameter may be 0, in which case the default values for the export parameters are used.
- Important! If you are working with ABBYY FineReader Engine loaded out-of-process, you must pass NULL for this parameter. If you want to pass the export parameters, create a user profile with the desired settings.
Return values
During export to PDF or XPS format this method may return FREN_E_INVALID_CREATION_DATE_FORMAT or FREN_E_INVALID_MODIFICATION_DATE_FORMAT errors, which indicate that the creation or modification date format is invalid. It also returns the standard return codes of ABBYY FineReader Engine functions.
Remarks
- In most cases, you must perform document synthesis before exporting the page. Omitting the document synthesis may cause errors during export. You may use for document synthesis either methods of the FRDocument object, or the IFRPage::Synthesize method.
- This method may report events to the listeners attached to the IConnectionPointContainer interface of the FRPage object.
See also
03.07.2024 8:50:25