Metodo OnProgress dell'interfaccia IProcessingEvents
Questo metodo è implementato lato client. Viene chiamato da ABBYY FineReader Engine per il metodo InjectTextLayer dell’oggetto Engine. Fornisce al client informazioni sulla percentuale approssimativa di completamento dell’operazione. La sua implementazione può mostrare un indicatore di avanzamento, come avviene in ABBYY FineReader. Può inoltre elaborare eventuali messaggi di sistema per evitare che l’applicazione sembri non rispondere durante operazioni prolungate.
Percentage[in] Questo parametro contiene la percentuale di lavoro attualmente completata. È compresa nell’intervallo da 0 a 100.Cancel[in, out] È possibile impostare questa variabile su TRUE per indicare che il processo deve essere interrotto. In questo caso, la funzione di elaborazione che segnala la percentuale restituisce E_ABORT.
[Solo C++] Se questo metodo restituisce un valore diverso da S_OK, significa che si è verificato un errore sul lato client e, in tal caso, il valore del Parameter Cancel non viene preso in considerazione.
L’implementazione client di questo metodo deve garantire che tutte le eccezioni generate all’interno del metodo vengano intercettate e gestite e che nessuna eccezione venga propagata fuori dal metodo. La propagazione di un’eccezione fuori dal metodo può portare a risultati imprevedibili, come la terminazione del programma.