Methode OpenImageFileFromMemory des Engine-Objekts

Diese Methode öffnet eine Bilddatei aus dem globalen Speicher, in den sie zuvor vom Benutzer geladen wurde.

Syntax

C++

Linux und 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

Parameter

DataPtr [in] Linux: Gibt die Adresse des Speicherblocks an, der die Bilddatei enthält. DataSize [in] Linux: Gibt die Größe des in den Speicher geladenen Bildes an. HGlobal [in] macOS und Windows: Gibt das HGLOBAL-Handle des Speicherblocks an, der die Bilddatei enthält. Das Handle wird als __int64 übergeben. Dieses Handle muss gültig sein. Callback [in] Diese Variable verweist auf die Schnittstelle des benutzerimplementierten Objekts vom Typ ImagePasswordCallback, das zur Verarbeitung möglicher Kennwortabfragen für den Zugriff auf Bilder im PDF-Format verwendet wird. Dieser Parameter ist optional und kann 0 sein. In diesem Fall können kennwortgeschützte Dateien nicht verarbeitet werden. PrepareMode [in] Verweist auf das Objekt PrepareImageMode, das angibt, wie ein Bild beim Öffnen vorverarbeitet wird. Dieser Parameter ist optional und kann 0 sein. In diesem Fall werden entweder die Standardparameter verwendet oder, falls ein Profil geladen wurde, die in diesem Profil festgelegten Parameter. FileName [in] Gibt den Namen der Bilddatei an. Diese Information wird verwendet, um das Dateiformat zu bestimmen, und in Fehlermeldungen. Dieser Parameter ist optional und kann 0 sein. Result [out, retval] Ein Zeiger auf die Zeigervariable IImageDocument*, die den Schnittstellenzeiger des resultierenden Objekts ImageDocument empfängt.

Rückgabewerte

Diese Methode hat keine spezifischen Rückgabewerte. Sie gibt die Standardrückgabewerte der Funktionen von ABBYY FineReader Engine zurück.

Bemerkungen

Beachten Sie, dass bei mehrseitigen Bilddateien das ImageDocument-Objekt nur aus der ersten Seite erstellt wird. Um alle Seiten der Datei zu öffnen, verwenden Sie die Methode AddImageFileFromMemory des Objekts FRDocument.
Diese Methode funktioniert nicht, wenn die Engine unter Linux als Out-of-Process-Server geladen wird oder wenn das Objekt unter Windows mit dem Objekt OutprocLoader erstellt wird.
Unter Windows unterstützt diese Methode nicht das Öffnen von WIC-kompatiblen Dateien.