Vai al contenuto principale
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.

Sintassi

C++

HRESULT OnProgress(
  int           Percentage,
  VARIANT_BOOL* Cancel
);

C#

void OnProgress(
  int      Percentage,
  ref bool Cancel
);

Visual Basic .NET

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

Parametri

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.

Valori di ritorno

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

Osservazioni

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.

Vedi anche

IProcessingEvents IEngine::InjectTextLayer