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 Document Viewer. Il processo può essere avviato in uno dei seguenti modi: Per sapere come chiamare questi comandi, vedere l’elenco Document Viewer Commands. Per sapere come chiamare questi comandi, vedere l’elenco Image Viewer Commands. Per sapere come chiamare questi comandi, vedere l’elenco Zoom Viewer Commands.
  • tramite l’API di FineReader Engine
Fornisce al client una percentuale approssimativa di avanzamento dell’operazione. La relativa implementazione può mostrare un indicatore di avanzamento. Elaborare gli eventuali messaggi di sistema per evitare che l’applicazione sembri non rispondere durante operazioni lunghe. Questo può risultare utile nelle applicazioni con interfaccia utente. Con questo metodo è possibile 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 del lavoro attualmente eseguito. È compresa nell’intervallo da 0 a 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à interrotto.

​
Valori di ritorno

[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 viene ignorato.

​
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ò causare comportamenti imprevedibili, fino alla terminazione del programma.

​
Vedi anche

DocumentViewer IDocumentViewerEvents