Vai al contenuto principale
Questo metodo è implementato lato client. Viene chiamato da ABBYY FineReader Engine durante l’analisi o il riconoscimento della pagina attiva in Image Viewer. Il processo può essere avviato in uno dei seguenti modi: Per sapere come richiamare questi comandi, consultare l’elenco Image Viewer Commands. Per sapere come richiamare questi comandi, consultare l’elenco Zoom Viewer Commands. Per sapere come richiamare questi comandi, consultare l’elenco Document Viewer Commands.
  • tramite l’API di FineReader Engine
Fornisce al client una percentuale approssimativa di avanzamento dell’operazione. La relativa implementazione può visualizzare un indicatore di avanzamento. Può anche elaborare eventuali messaggi di sistema per evitare che l’applicazione sembri bloccata durante operazioni lunghe. Questo può risultare utile nelle applicazioni con interfaccia utente. Questo metodo consente inoltre di annullare l’operazione.

​
Sintassi

​
C++

HRESULT OnProgress(
  int           Percentage,
  VARIANT_BOOL* Cancel
);

​
C#

void OnProgress(
  int      Percentage,
  out bool Cancel
);

​
Visual Basic .NET

Sub OnProgress( _
  Percentage As Integer, _
  ByRef Cancel As Boolean _
)

​
Parametri

Percentage [in] Contiene la percentuale di lavoro attualmente completata. Il valore è compreso tra 0 e 100. Cancel [out] È possibile impostare questa variabile su TRUE per indicare che il processo deve essere terminato. In questo caso, il processo di analisi o riconoscimento verrà interrotto.

​
Valori di ritorno

[Solo per 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 parametro Cancel non viene preso in considerazione.

​
Osservazioni

L’implementazione lato 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 al di fuori del metodo. La propagazione di un’eccezione al di fuori del metodo può portare a risultati imprevedibili (come la terminazione del programma).

​
Vedi anche

ImageViewer IImageViewerEvents