Pular para o conteúdo principal
Esse método descarrega e, se necessário, salva em disco os objetos ImageDocument e Layout correspondentes ao objeto FRPage, se não houver referências a eles. Salvar em disco é opcional; você pode omitir essa etapa se os dados não tiverem sido alterados. O método é útil ao processar documentos grandes, pois, nesse caso, reduz o uso de memória. Depois que a operação em uma página individual do documento for concluída, libere todas as referências aos objetos ImageDocument e Layout correspondentes à página e chame o método Flush para reduzir o uso de memória. Observe que, se você tiver feito alterações na página e quiser preservá-las, deverá chamar Flush com o parâmetro IsSaveRequired definido como TRUE. Caso contrário, as alterações poderão ser perdidas ao chamar outros métodos que liberam memória (consulte Percorrendo as páginas do documento para mais detalhes).

Sintaxe

C++

HRESULT Flush(
  VARIANT_BOOL  IsSaveRequired,
  VARIANT_BOOL* Result
);

C#

bool Flush(bool IsSaveRequired);

Visual Basic .NET

Function Flush(Boolean IsSaveRequired) As Boolean

Parâmetros

IsSaveRequired [in] Especifica se as alterações feitas na página devem ser salvas. Passe FALSE se a página não tiver sido alterada ou se não for necessário salvar essas alterações. Result [out, retval] Ponteiro para a variável que recebe o resultado da execução do método. O resultado é TRUE se o método for concluído com êxito; caso contrário, FALSE.

Valores de retorno

Este método não possui valores de retorno específicos. Ele retorna os códigos de retorno padrão das funções do ABBYY FineReader Engine.

Observações

No Windows, o comportamento do método Flush depende do valor da propriedade IFRDocument::PageFlushingPolicy. Se o valor de PageFlushingPolicy for PFP_FlushToDisk, uma chamada ao método descarrega para o disco os documentos de layout e de imagem. Se for PFP_Auto, uma chamada ao método descarrega os dados para o disco se houver mais de 30 páginas no documento; caso contrário, os dados são mantidos na memória. Se for PFP_KeepInMemory, os dados não são descarregados. Isso é conveniente quando você processa documentos pequenos e grandes em uma mesma solução, pois pode usar o mesmo código para o processamento.

Veja também

FRPage IFRDocument::PageFlushingPolicy
Percorrendo as páginas do documento