Metodo OnProgress dell'interfaccia IZoomViewerEvents
Questo metodo è implementato sul lato client. Viene chiamato da ABBYY FineReader Engine durante l’analisi o il riconoscimento della pagina attiva in Zoom Viewer. Il processo può essere avviato in uno dei seguenti modi:
Per sapere come possono essere chiamati questi comandi, consulta l’elenco Document Viewer Commands.
tramite l’API di FineReader Engine
Fornisce al client una percentuale approssimativa di avanzamento dell’operazione. La sua implementazione può mostrare un indicatore di avanzamento. Può anche elaborare eventuali messaggi di sistema per evitare che l’applicazione sembri bloccata durante le operazioni lunghe. Questa funzionalità può essere utile nelle applicazioni con interfaccia utente. Con questo metodo è inoltre possibile annullare l’operazione.
Percentage[in] Contiene la percentuale di lavoro completata fino a questo momento. È compresa tra 0 e 100.Cancel[out] È possibile impostare questa variabile su TRUE per indicare che il processo deve essere interrotto. In questo caso, il processo di analisi o riconoscimento verrà annullato.
[Solo per C++] Se questo metodo restituisce un valore diverso da S_OK, significa che si è verificato un errore lato client e, in tal caso, il valore del parametro Cancel non viene considerato.
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 si propaghi all’esterno del metodo. La propagazione di un’eccezione al di fuori del metodo può portare a risultati imprevedibili, come la terminazione del programma.