Flush-Methode des FRPage-Objekts

Flush-Methode des FRPage-Objekts in der ABBYY FineReader Engine API — entlädt ImageDocument und Layout für die Seite (optional mit Speicherung auf der Festplatte), wenn keine Verweise vorhanden sind; nützlich, um den Speicherverbrauch bei großen Dokumenten zu verringern.

Diese Methode entlädt die Objekte ImageDocument und Layout, die dem Objekt FRPage entsprechen, und speichert sie bei Bedarf auf der Festplatte, sofern keine Verweise mehr auf sie vorhanden sind. Das Speichern auf der Festplatte ist optional; Sie können diese Stufe überspringen, wenn die Daten nicht geändert wurden.

Die Methode ist bei der Verarbeitung großer Dokumente nützlich, da sie den Speicherverbrauch verringert. Nachdem die Verarbeitung einer einzelnen Dokumentseite abgeschlossen ist, geben Sie alle Verweise auf die der Seite entsprechenden Objekte ImageDocument und Layout frei und rufen Sie dann die Flush-Methode auf, um den Speicherverbrauch zu verringern.

Beachten Sie, dass Sie Flush mit dem Parameter IsSaveRequired=TRUE aufrufen sollten, wenn Sie Änderungen an der Seite vorgenommen haben und diese beibehalten möchten. Andernfalls können die Änderungen beim Aufruf anderer Methoden, die Speicher freigeben, verloren gehen (weitere Informationen finden Sie unter Dokumentseiten durchlaufen).”

​

Syntax

​

C++

HRESULT Flush(
  VARIANT_BOOL  IsSaveRequired,
  VARIANT_BOOL* Result
);

​

C#

bool Flush(bool IsSaveRequired);

​

Visual Basic .NET

Function Flush(Boolean IsSaveRequired) As Boolean

​

Parameter

IsSaveRequired

[in] Gibt an, ob die an der Seite vorgenommenen Änderungen gespeichert werden sollen. Übergeben Sie FALSE, wenn die Seite nicht geändert wurde oder das Speichern der Änderungen nicht erforderlich ist.

Result

[out, retval] Zeiger auf die Variable, die das Ergebnis der Methodenausführung empfängt. Das Ergebnis ist TRUE, wenn die Methode erfolgreich abgeschlossen wurde, andernfalls FALSE.

​

Rückgabewerte

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

​

Hinweise

Unter Windows hängt das Verhalten der Flush-Methode vom Wert der Eigenschaft IFRDocument::PageFlushingPolicy ab. Wenn der Wert von PageFlushingPolicy PFP_FlushToDisk ist, werden bei einem Aufruf der Methode Layout- und Bilddaten auf dem Datenträger gespeichert. Wenn der Wert PFP_Auto ist, speichert ein Aufruf der Methode die Daten auf dem Datenträger, wenn das Dokument mehr als 30 Seiten umfasst; andernfalls bleiben die Daten im Speicher. Wenn der Wert PFP_KeepInMemory ist, werden die Daten nicht ausgelagert. Das ist praktisch, wenn Sie in einer Lösung sowohl kleine als auch große Dokumente verarbeiten, da Sie für die Verarbeitung denselben Code verwenden können.

​

Siehe auch

FRPage

IFRDocument::PageFlushingPolicy
Dokumentseiten durchlaufen