Methode AddImageFileFromStream des FRDocument-Objekts

Diese Methode öffnet eine Bilddatei aus einem vom Benutzer implementierten Eingabestream und fügt die Seiten der geöffneten Datei dem Dokument hinzu. Unter Windows unterscheidet sich diese Methode von der Methode AddImageFileFromMemory dadurch, dass sie verwendet werden kann, wenn das Engine-Objekt mithilfe des Objekts OutprocLoader erstellt wird.

Syntax

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

Parameter

Stream [in] Verweist auf die Schnittstelle des vom Benutzer implementierten Objekts vom Typ IReadStream, das die Bilddatei enthält, die dem Dokument hinzugefügt werden soll. Callback [in] Diese Variable verweist auf die Schnittstelle des vom Benutzer implementierten 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. PageIndices [in] Dieser Parameter verweist auf das Objekt IntsCollection, das die Indizes der Seiten angibt, die dem Dokument hinzugefügt werden sollen. Beachten Sie, dass doppelte Indizes nicht zulässig sind. Um dieselbe Seite mehrmals hinzuzufügen, rufen Sie diese Methode bitte mehrmals auf.
Dieser Parameter ist optional und kann 0 sein; in diesem Fall werden dem Dokument alle Seiten der geöffneten Datei hinzugefügt. FileName [in] Gibt den Namen der Bilddatei an. Diese Information wird verwendet, um das Dateiformat zu bestimmen, falls es nicht explizit angegeben ist, sowie in Fehlermeldungen. Dieser Parameter ist optional und kann 0 sein. Unter Windows und Linux: Übergeben Sie zum Öffnen der Office-Formate den Namen des Dokuments einschließlich Dateierweiterung.

Rückgabewerte

Diese Methode hat keine eigenen Rückgabewerte. Sie gibt die Standard-Rückgabewerte von ABBYY FineReader Engine-Funktionen zurück.

Hinweise

Dateien im SVG-Format können nicht aus einem Stream geöffnet werden.
Wenn Sie mit dieser Methode eine PDF Portfolio-Datei öffnen, wird ihre Titelseite immer in die Ausgabedatei aufgenommen.
Diese Methode kann Ereignisse an Listener senden, die an die Schnittstelle IConnectionPointContainer des Objekts FRDocument gebunden sind.
Für Linux und Windows:
- Wenn Ihre Lizenz das Modul Office Formats Opening umfasst, können Sie diese Methode auch verwenden, um digitale Dokumente in unterstützten Formaten zu öffnen.
- Abhängig vom Wert der Eigenschaft IEngine::MultiProcessingParams kann ABBYY FineReader Engine das Öffnen mehrseitiger Dokumente auf die CPU-Kerne verteilen.
Für Linux: Diese Methode funktioniert nicht, wenn das Engine-Objekt als Out-of-Process-Server geladen ist.
Für Windows: Diese Methode unterstützt das Öffnen von WIC-kompatiblen Dateien nicht.