Flush Method of the FRPage Object

This method unloads and, if necessary, saves to disk the ImageDocument and the Layout objects corresponding to the FRPage object if there are no references to them. Saving to disk is an option, you can omit this stage if the data has not been changed.

The method is useful when processing documents of large sizes, in which case it decreases memory usage. After the operation on a separate document page is complete, free all references to the ImageDocument and the Layout objects corresponding to the page and call the Flush method to decrease memory usage.

Note that if you have made changes to the page and want to keep these changes, you should call Flush with the IsSaveRequired parameter set to TRUE. Otherwise, the changes can be lost when calling other methods that free memory (see Iterating Document Pages for details).

Syntax

HRESULT Flush(
  VARIANT_BOOL  IsSaveRequired,
  VARIANT_BOOL* Result
);
    

Parameters

IsSaveRequired
[in] Specifies whether to save changes done to the page. Pass FALSE if the page has not been changed or saving changes is not required.
Result
[out, retval] The pointer to the variable that receives the method execution result. The result is TRUE if the method completed successfully, and FALSE otherwise.

Return values

This method has no specific return values. It returns standard return codes of ABBYY FineReader Engine functions.

See also

FRPage

IFRDocument::PageFlushingPolicy
Iterating Document Pages

03.07.2024 8:50:25

Usage of Cookies. In order to optimize the website functionality and improve your online experience ABBYY uses cookies. You agree to the usage of cookies when you continue using this site. Further details can be found in our Privacy Notice.