Vai al contenuto principale
Questo metodo rimuove dalla memoria e, se necessario, salva su disco gli oggetti ImageDocument e Layout corrispondenti all’oggetto FRPage, se non esistono riferimenti a tali oggetti. Il salvataggio su disco è facoltativo; è possibile omettere questa fase se i dati non sono stati modificati. Il metodo è utile durante l’elaborazione di documenti di grandi dimensioni, poiché in questo modo riduce l’utilizzo della memoria. Dopo aver completato l’operazione su una singola pagina del documento, rilasciare tutti i riferimenti agli oggetti ImageDocument e Layout corrispondenti alla pagina e chiamare il metodo Flush per ridurre l’utilizzo della memoria. Si noti che, se sono state apportate modifiche alla pagina e si desidera conservarle, è necessario chiamare Flush con il parametro IsSaveRequired impostato su TRUE. In caso contrario, le modifiche potrebbero andare perse quando si chiamano altri metodi che liberano memoria (per ulteriori dettagli, vedere Iterazione delle pagine del documento).

​
Sintassi

​
C++

HRESULT Flush(
  VARIANT_BOOL  IsSaveRequired,
  VARIANT_BOOL* Result
);

​
C#

bool Flush(bool IsSaveRequired);

​
Visual Basic .NET

Function Flush(Boolean IsSaveRequired) As Boolean

​
Parametri

IsSaveRequired [in] Specifica se salvare le modifiche apportate alla pagina. Passare FALSE se la pagina non è stata modificata o se non è necessario salvare le modifiche. Result [out, retval] Puntatore alla variabile che riceve il risultato dell’esecuzione del metodo. Il risultato è TRUE se il metodo è stato completato correttamente e FALSE in caso contrario.

​
Valori di ritorno

Questo metodo non ha valori di ritorno specifici. Restituisce i codici di ritorno standard delle funzioni di ABBYY FineReader Engine.

​
Note

In Windows, il comportamento del metodo Flush dipende dal valore della proprietà IFRDocument::PageFlushingPolicy. Se il valore di PageFlushingPolicy è PFP_FlushToDisk, una chiamata al metodo scarica su disco i documenti di layout e di immagine. Se è PFP_Auto, una chiamata al metodo scarica i dati su disco se il documento contiene più di 30 pagine; in caso contrario, i dati vengono mantenuti in memoria. Se è PFP_KeepInMemory, i dati non vengono scaricati. Questo è utile quando si elaborano documenti sia piccoli che grandi nella stessa soluzione, poiché è possibile usare lo stesso codice di elaborazione.

​
Vedi anche

FRPage IFRDocument::PageFlushingPolicy
Iterazione delle pagine del documento