Zum Hauptinhalt springen
Diese Methode speichert die angegebenen Seiten als Datei in einem externen Format. Die verfügbaren Dateiformate sind als Konstanten der Aufzählung FileExportFormatEnum definiert.
Unter Linux und Windows wird die Parallelverarbeitung nur beim Export in die Formate PDF (außer im Modus TextOnly) und PPTX unterstützt.

​
Syntax

​
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] _
)

​
Parameter

ExportFileName [in] Diese Variable enthält den vollständigen Pfad zur Ausgabedatei. Wenn diese Datei bereits vorhanden ist, wird sie ohne Rückfrage überschrieben. Format [in] Diese Variable gibt das Format der Ausgabedatei an. Eine Beschreibung der unterstützten Dateiformate finden Sie unter FileExportFormatEnum. ExportParams [in] Übergeben Sie über diesen Eingabeparameter das Exportparameterobjekt des Typs, der Ihrem Dateiformat entspricht. Wenn Sie beispielsweise den Text in einer RTF-Datei speichern, erstellen Sie ein Objekt vom Typ RTFExportParams, legen Sie darin die erforderlichen Parameter fest und übergeben Sie es als Eingabeparameter ExportParams an diese Methode. Dieser Parameter kann 0 sein; in diesem Fall werden die Standardwerte für die Exportparameter verwendet.
Unter Linux müssen Sie für diesen Parameter NULL übergeben, wenn Sie mit ABBYY FineReader Engine arbeiten, das außerhalb des Prozesses geladen wurde. Wenn Sie Exportparameter übergeben möchten, erstellen Sie ein Benutzerprofil mit den gewünschten Einstellungen.
PageIndices [in] Dieser Parameter verweist auf das Objekt IntsCollection, das die Nummern der zu exportierenden Seiten enthält. Die Seiten werden in der Reihenfolge exportiert, in der sie sich im Dokument befinden. Wenn Sie die Seitenreihenfolge ändern möchten, sollten Sie die Seiten im Dokument mit der Methode Renumber der entsprechenden Sammlung FRPages neu nummerieren. AdditionalFiles [out] Ein Zeiger auf die Zeigervariable IStringsCollection*, die den Schnittstellenzeiger des Objekts StringsCollection empfängt. *AdditionalFiles darf auf kein gültiges Objekt verweisen. Die StringsCollection wird intern von dieser Methode erstellt. Dieses Objekt enthält die Liste der vollständigen Pfade zu den zusätzlichen Dateien, die während des Exports erzeugt wurden. AdditionalDirectories [out] Ein Zeiger auf die Zeigervariable IStringsCollection*, die den Schnittstellenzeiger des Objekts StringsCollection empfängt. *AdditionalDirectories darf auf kein gültiges Objekt verweisen. Die StringsCollection wird intern von dieser Methode erstellt. Dieses Objekt enthält die Liste der vollständigen Pfade zu den zusätzlichen Verzeichnissen, die während des Exports erzeugt wurden.

​
Rückgabewerte

Beim Export in das PDF- oder XPS-Format kann diese Methode die Fehler FREN_E_INVALID_CREATION_DATE_FORMAT oder FREN_E_INVALID_MODIFICATION_DATE_FORMAT zurückgeben, die darauf hinweisen, dass das Format des Erstellungs- oder Änderungsdatums ungültig ist. Darüber hinaus gibt sie die Standard-Rückgabecodes der ABBYY FineReader Engine-Funktionen zurück.

​
Hinweise

  • In den meisten Fällen muss die Dokumentensynthese durchgeführt werden, bevor Seiten eines Dokuments exportiert werden. Wird die Dokumentensynthese ausgelassen, kann es beim Export zu Fehlern kommen. Ausführliche Informationen finden Sie in der Beschreibung der Methode IFRDocument::SynthesizePages.
  • Diese Methode kann Ereignisse an die Listener übermitteln, die an die IConnectionPointContainer-Schnittstelle des Objekts FRDocument angehängt sind.
  • Für Linux und Windows: Abhängig vom Wert der Eigenschaft IEngine::MultiProcessingParams kann ABBYY FineReader Engine den Export mehrseitiger Dokumente auf die CPU-Kerne verteilen.

​
Siehe auch

FRDocument