Méthode AddImageFileFromStream de l’objet FRDocument

Cette méthode ouvre un fichier image à partir du flux d’entrée implémenté par l’utilisateur et ajoute au document les pages du fichier ouvert.

Sous Windows, cette méthode diffère de la méthode AddImageFileFromMemory en ce qu’elle peut être utilisée lorsque l’objet Engine est créé à l’aide de l’objet OutprocLoader.

​

Syntaxe

​

C++

HRESULT AddImageFileFromStream(
  IReadStream*            Stream,
  IImagePasswordCallback* Callback,
  IPrepareImageMode*      PrepareMode,
  IIntsCollection*        PageIndices,
  BSTR                    FileName
);

​

C#

void AddImageFileFromStream(
  IReadStream             Stream,
  IImagePasswordCallback  Callback,
  IPrepareImageMode       PrepareMode,
  IIntsCollection         PageIndices,
  string                  FileName
);

​

Visual Basic .NET

Sub AddImageFileFromStream( _
  Stream As IReadStream, _
  Callback As IImagePasswordCallback, _
  [PrepareMode As IPrepareImageMode = Nothing], _
  [PageIndices As IIntsCollection = Nothing], _
  [FileName As String = "0"] _
)

​

Parameters

Stream

[in] Fait référence à l’interface de l’objet implémenté par l’utilisateur de type IReadStream qui contient le fichier image à ajouter au document.

Callback

[in] Cette variable fait référence à l’interface de l’objet implémenté par l’utilisateur de type ImagePasswordCallback, utilisé pour gérer les éventuelles demandes de mot de passe lors de l’accès aux images au format PDF. Ce paramètre est facultatif et peut valoir 0, auquel cas les fichiers protégés par mot de passe ne peuvent pas être traités.

PrepareMode

[in] Fait référence à l’objet PrepareImageMode qui spécifie la manière dont une image sera prétraitée lors de son ouverture. Ce paramètre est facultatif et peut valoir 0, auquel cas les paramètres par défaut sont utilisés ou, si un profil a été chargé, les paramètres définis par ce profil sont appliqués.

PageIndices

[in] Ce paramètre fait référence à l’objet IntsCollection qui spécifie les indices des pages à ajouter au document. Les indices répétés ne sont pas autorisés. Pour ajouter plusieurs fois la même page, appelez cette méthode plusieurs fois.
Ce paramètre est facultatif et peut valoir 0, auquel cas toutes les pages du fichier ouvert sont ajoutées au document.

FileName

[in] Spécifie le nom du fichier image. Cette information est utilisée pour déterminer le format du fichier, si celui-ci n’est pas explicitement spécifié, et apparaît dans les messages d’erreur. Ce paramètre est facultatif et peut valoir 0.

Sous Windows et Linux : pour ouvrir les formats office, passez le nom du document avec son extension.

​

Valeurs de retour

Cette méthode n’a pas de valeur de retour spécifique. Elle renvoie les valeurs de retour standard des fonctions d’ABBYY FineReader Engine.

​

Remarques

• Les fichiers au format SVG ne peuvent pas être ouverts depuis un flux.
• Lors de l’ouverture d’un fichier PDF Portfolio à l’aide de cette méthode, sa page de garde est toujours incluse dans le fichier de sortie.
• Cette méthode peut déclencher des événements pour les écouteurs rattachés à l’interface IConnectionPointContainer de l’objet FRDocument.
• Pour Linux et Windows :
  • Si votre licence inclut le module Ouverture des formats Office, vous pouvez également utiliser cette méthode pour ouvrir des documents numériques dans des formats pris en charge.
  • Selon la valeur de la propriété IEngine::MultiProcessingParams, ABBYY FineReader Engine peut répartir l’ouverture des documents multipages entre les cœurs du processeur.
• Pour Linux : cette méthode ne fonctionne pas si l’objet Engine est chargé en tant que serveur hors processus.
• Pour Windows : cette méthode ne prend pas en charge l’ouverture des fichiers compatibles WIC.

​

Voir aussi

FRDocument