Este método salva as páginas especificadas em um arquivo em formato externo. Os formatos de arquivo disponíveis são representados pelas constantes da enumeração FileExportFormatEnum.
No Linux e no Windows, há suporte a processamento paralelo apenas para exportação nos formatos PDF (exceto no modo TextOnly) e PPTX.
HRESULT ExportPages(
BSTR ExportFileName,
FileExportFormatEnum Format,
IUnknown* ExportParams,
IIntsCollection* PageIndices,
IStringsCollection** AdditionalFiles,
IStringsCollection** AdditionalDirectories
);
void ExportPages(
string ExportFileName,
FileExportFormatEnum Format,
object ExportParams,
IIntsCollection PageIndices,
out IStringsCollection AdditionalFiles,
out IStringsCollection AdditionalDirectories
);
Sub ExportPages( _
ExportFileName As String, _
Format As FileExportFormatEnum, _
ExportParams As Unknown, _
PageIndices As IIntsCollection, _
[ByRef AdditionalFiles As IStringsCollection = Nothing], _
[ByRef AdditionalDirectories As IStringsCollection = Nothing] _
)
ExportFileName
[in] Esta variável contém o caminho completo do arquivo de saída. Se esse arquivo já existir, ele será sobrescrito sem confirmação.
Format
[in] Esta variável especifica o formato do arquivo de saída. Consulte a descrição de FileExportFormatEnum para ver os formatos de arquivo compatíveis.
ExportParams
[in] Passe, por meio deste parâmetro de entrada, o objeto de parâmetros de exportação do tipo correspondente ao formato do arquivo. Por exemplo, se você estiver salvando o texto em um arquivo RTF, crie um objeto RTFExportParams, defina nele os parâmetros necessários e passe-o para este método como parâmetro de entrada ExportParams. Esse parâmetro pode ser 0; nesse caso, serão usados os valores padrão dos parâmetros de exportação.
No Linux, se você estiver trabalhando com o ABBYY FineReader Engine carregado out-of-process, deverá passar NULL para esse parâmetro. Se quiser passar os parâmetros de exportação, crie um perfil de usuário com as configurações desejadas.
PageIndices
[in] Este parâmetro se refere ao objeto IntsCollection, que contém os números das páginas a serem exportadas. As páginas são exportadas na ordem em que aparecem no documento. Se quiser alterar a ordem das páginas, renumere as páginas no documento usando o método Renumber da coleção FRPages correspondente.
AdditionalFiles
[out] Um ponteiro para a variável de ponteiro IStringsCollection* que recebe o ponteiro de interface do objeto StringsCollection. *AdditionalFiles não deve se referir a nenhum objeto válido. O objeto StringsCollection é criado internamente por este método. Esse objeto contém a lista de caminhos completos dos arquivos adicionais gerados durante a exportação.
AdditionalDirectories
[out] Um ponteiro para a variável de ponteiro IStringsCollection* que recebe o ponteiro de interface do objeto StringsCollection. *AdditionalDirectories não deve se referir a nenhum objeto válido. O objeto StringsCollection é criado internamente por este método. Esse objeto contém a lista de caminhos completos dos diretórios adicionais gerados durante a exportação.
Durante a exportação para PDF ou XPS, este método pode retornar os erros FREN_E_INVALID_CREATION_DATE_FORMAT ou FREN_E_INVALID_MODIFICATION_DATE_FORMAT, que indicam que o formato da data de criação ou da data de modificação é inválido. Ele também retorna os códigos de retorno padrão das funções do ABBYY FineReader Engine.
- Na maioria dos casos, a síntese do documento deve ser realizada antes de exportar as páginas de um documento. Omitir a síntese do documento pode causar erros durante a exportação. Consulte a descrição do método IFRDocument::SynthesizePages para mais detalhes.
- Este método pode notificar eventos aos listeners associados à interface IConnectionPointContainer do objeto FRDocument.
- Para Linux e Windows: dependendo do valor da propriedade IEngine::MultiProcessingParams, o ABBYY FineReader Engine pode distribuir a exportação de documentos com várias páginas pelos núcleos de CPU.
FRDocument