Méthode OpenImageFileFromMemory de l'objet Engine

Cette méthode ouvre un fichier d’image à partir de la mémoire globale, dans laquelle il a été préalablement chargé par l’utilisateur.

​

Syntaxe

​

C++

​

Linux et macOS

HRESULT OpenImageFileFromMemory(
  void*                   DataPtr,
  __int64                 DataSize,
  IImagePasswordCallback* Callback,
  IPrepareImageMode*      PrepareMode,
  BSTR                    FileName
  IImageDocument**        Result
);

​

Windows

HRESULT OpenImageFileFromMemory(
  __int64                 HGlobal,
  IImagePasswordCallback* Callback,
  IPrepareImageMode*      PrepareMode,
  BSTR                    FileName
  IImageDocument**        Result
);

​

C#

IImageDocument OpenImageFileFromMemory(
  Int64                   HGlobal,
  IImagePasswordCallback  Callback,
  IPrepareImageMode       PrepareMode,
  string                  FileName
);

​

Visual Basic .NET

Function OpenImageFileFromMemory( _
  HGlobal As Int64, _
  Callback As IImagePasswordCallback, _
  [PrepareMode As IPrepareImageMode = Nothing], _
  [FileName As String = "0"] _
) As IImageDocument

​

Paramètres

DataPtr

[in] Linux : spécifie l’adresse du bloc mémoire qui contient le fichier image.

DataSize

[in] Linux : spécifie la taille de l’image chargée en mémoire.

HGlobal

[in] macOS et Windows : spécifie le handle HGLOBAL du bloc mémoire qui contient le fichier image. Le handle est transmis sous la forme de __int64. Ce handle doit être valide.

Callback

[in] Cette variable désigne l’interface d’un objet de type ImagePasswordCallback implémenté par l’utilisateur, utilisée pour gérer d’éventuelles demandes de mot de passe lors de l’accès à des images au format PDF. Ce paramètre est facultatif et peut être égal à 0. Dans ce 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 comment une image sera prétraitée lors de l’ouverture. Ce paramètre est facultatif et peut être égal à 0. Dans ce cas, les paramètres par défaut sont utilisés ou, si un profil a été chargé, les paramètres définis dans ce profil sont appliqués.

FileName

[in] Spécifie le nom du fichier image. Cette information est utilisée pour déterminer le format du fichier et dans les messages d’erreur. Ce paramètre est facultatif et peut être égal à 0.

Result

[out, retval] Pointeur vers une variable pointeur IImageDocument* qui reçoit le pointeur d’interface de l’objet ImageDocument résultant.

​

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

• Notez que, pour les fichiers image multipages, l’objet ImageDocument sera créé uniquement à partir de la première page. Pour ouvrir toutes les pages du fichier, utilisez la méthode AddImageFileFromMemory de l’objet FRDocument.
• Cette méthode ne fonctionne pas si l’Engine est chargé comme serveur hors processus sous Linux ou si l’objet est créé à l’aide de l’objet OutprocLoader sous Windows.
• Sous Windows, cette méthode ne prend pas en charge l’ouverture des fichiers compatibles WIC.

​

Voir aussi

Engine

IFRDocument::AddImageFileFromMemory