CreateMultipageImageWriter-Methode des Engine-Objekts

Diese Methode erstellt ein MultipageImageWriter-Objekt, mit dem mehrere Bilder mit erweiterten Speicherparametern in einer einzigen mehrseitigen Bilddatei gespeichert werden können.

Syntax

C++

HRESULT CreateMultipageImageWriter(
  BSTR                    FileName,
  ImageFileFormatEnum     FileFormat,
  IUnknown*               ExtendedParams,
  IMultipageImageWriter** Result
);

C#

IMultipageImageWriter CreateMultipageImageWriter(
  string               FileName,
  IImageFileFormatEnum FileFormat,
  object               ExtendedParams
);

Visual Basic .NET

Function CreateMultipageImageWriter( _
  FileName       As String, _
  FileFormat     As IImageFileFormatEnum, _
  ExtendedParams As Object _
) As IMultipageImageWriter

Parameter

FileName [in] Dieser Parameter enthält den vollständigen Pfad zur mehrseitigen Bilddatei, in der die Bilder gespeichert werden. Zum Beispiel: C:\MyPic.tif, /opt/MyPic.tif, /Users/user/Pictures/MyPic.tif. Wenn bereits eine Datei mit diesem Namen existiert, wird sie ohne Rückfrage überschrieben. FileFormat [in] Eine Variable vom Typ ImageFileFormatEnum, die das Format der Ausgabedatei angibt. Nicht alle in dieser Enumeration definierten Formate werden zum Schreiben unterstützt. ExtendedParams [in] Diese Variable verweist auf ein Objekt vom Typ JpegExtendedParams oder TiffExtendedParams, das die Parameter zum Speichern des Bildes im JPEG- bzw. TIFF-Format definiert. Dieser Parameter ist optional und kann NULL sein.

Unter Linux müssen Sie für diesen Parameter NULL übergeben, wenn Sie mit ABBYY FineReader Engine arbeiten, die out-of-process geladen wurde.

Result [out, retval] Ein Zeiger auf eine IMultipageImageWriter*-Zeigervariable, die den Schnittstellenzeiger des Ausgabeobjekts MultipageImageWriter empfängt. Dieses Objekt ermöglicht das Anhängen von Bildern an das Ende der mehrseitigen Bilddatei.

Rückgabewerte

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

Bemerkungen

Beachten Sie, dass nicht alle zum Schreiben verfügbaren Formate für mehrseitige Bilder geeignet sind. Daher können Sie das MultipageImageWriter-Objekt zwar für einseitige Formate erstellen, der resultierenden Datei jedoch höchstens eine Seite hinzufügen.