Passer au contenu principal
Cette méthode enregistre les pages spécifiées dans un fichier dans un format externe. Les formats de fichier disponibles sont représentés par les constantes de l’énumération FileExportFormatEnum.
Sous Linux et Windows, le traitement parallèle est pris en charge uniquement pour l’exportation aux formats PDF (à l’exception du mode TextOnly) et PPTX.

Syntaxe

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

Paramètres

ExportFileName [in] Cette variable contient le chemin complet du fichier de sortie. Si ce fichier existe déjà, il est remplacé sans invite de confirmation. Format [in] Cette variable spécifie le format du fichier de sortie. Voir la description de FileExportFormatEnum pour connaître les formats de fichier pris en charge. ExportParams [in] Passez, via ce paramètre d’entrée, l’objet de paramètres d’exportation du type correspondant à votre format de fichier. Par exemple, si vous enregistrez le texte dans un fichier RTF, créez un objet RTFExportParams, définissez-y les paramètres nécessaires, puis transmettez-le à cette méthode en tant que paramètre d’entrée ExportParams. Ce paramètre peut être 0, auquel cas les valeurs par défaut des paramètres d’exportation sont utilisées.
Sous Linux, si vous travaillez avec ABBYY FineReader Engine chargé hors processus, vous devez passer NULL pour ce paramètre. Si vous souhaitez transmettre les paramètres d’exportation, créez un profil utilisateur avec les paramètres souhaités.
PageIndices [in] Ce paramètre fait référence à l’objet IntsCollection, qui contient les numéros des pages à exporter. Les pages sont exportées dans l’ordre dans lequel elles se trouvent dans le document. Si vous souhaitez modifier l’ordre des pages, vous devez renuméroter les pages du document à l’aide de la méthode Renumber de la collection FRPages correspondante. AdditionalFiles [out] Pointeur vers la variable pointeur IStringsCollection* qui reçoit le pointeur d’interface de l’objet StringsCollection. *AdditionalFiles ne doit faire référence à aucun objet valide. L’objet StringsCollection est créé en interne par cette méthode. Cet objet contient la liste des chemins complets vers les fichiers supplémentaires générés lors de l’exportation. AdditionalDirectories [out] Pointeur vers la variable pointeur IStringsCollection* qui reçoit le pointeur d’interface de l’objet StringsCollection. *AdditionalDirectories ne doit faire référence à aucun objet valide. L’objet StringsCollection est créé en interne par cette méthode. Cet objet contient la liste des chemins complets vers les répertoires supplémentaires générés lors de l’exportation.

Valeurs de retour

Lors de l’exportation au format PDF ou XPS, cette méthode peut renvoyer les erreurs FREN_E_INVALID_CREATION_DATE_FORMAT ou FREN_E_INVALID_MODIFICATION_DATE_FORMAT, qui indiquent que le format de la date de création ou de modification est invalide. Elle renvoie également les codes de retour standard des fonctions d’ABBYY FineReader Engine.

Remarques

  • Dans la plupart des cas, la synthèse de documents doit être effectuée avant l’exportation des pages d’un document. L’absence de synthèse de documents peut provoquer des erreurs lors de l’exportation. Voir la description de la méthode IFRDocument::SynthesizePages pour plus de détails.
  • Cette méthode peut signaler des événements aux écouteurs associés à l’interface IConnectionPointContainer de l’objet FRDocument.
  • Pour Linux et Windows : selon la valeur de la propriété IEngine::MultiProcessingParams, ABBYY FineReader Engine peut répartir l’exportation des documents multipages entre les cœurs du processeur.

Voir aussi

FRDocument