Pular para o conteúdo principal
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.

Sintaxe

C++

HRESULT ExportPages(
  BSTR                 ExportFileName,
  FileExportFormatEnum Format,
  IUnknown*            ExportParams,
  IIntsCollection*     PageIndices,
  IStringsCollection** AdditionalFiles,
  IStringsCollection** AdditionalDirectories
);

C#

void ExportPages(
  string                ExportFileName,
  FileExportFormatEnum  Format,
  object                ExportParams,
  IIntsCollection        PageIndices,
  out IStringsCollection AdditionalFiles,
  out IStringsCollection AdditionalDirectories
);

Visual Basic .NET

Sub ExportPages( _
  ExportFileName As String, _
  Format As FileExportFormatEnum, _
  ExportParams As Unknown, _
  PageIndices As IIntsCollection, _
  [ByRef AdditionalFiles As IStringsCollection = Nothing], _
  [ByRef AdditionalDirectories As IStringsCollection = Nothing] _
)

Parâmetros

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.

Valores de retorno

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.

Observações

  • 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.

Veja também

FRDocument