Vai al contenuto principale
Questo metodo è implementato lato client. Viene chiamato da ABBYY FineReader Engine per alcuni metodi dell’oggetto FRPage. Fornisce al client informazioni approssimative sulla percentuale di completamento dell’operazione corrente (analisi, riconoscimento ed esportazione). La sua implementazione può visualizzare un indicatore di avanzamento, come in ABBYY FineReader.
In Windows, può anche elaborare eventuali messaggi di sistema per evitare che l’applicazione sembri non rispondere durante operazioni lunghe. Questo può essere utile nelle applicazioni con interfaccia utente.

Sintassi

C++

HRESULT OnProgress(
  IFRPage*      Sender,
  int           Percentage,
  VARIANT_BOOL* Cancel
);

C#

void OnProgress(
  IFRPage   Sender,
  int      Percentage,
  ref bool Cancel
);

Visual Basic .NET

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

Parametri

Sender [in] Questo parametro fa riferimento all’oggetto FRPage che invia le notifiche. Percentage [in] Questo parametro indica la percentuale di lavoro attualmente completata. È compresa tra 0 e 100. Cancel [in, out] È possibile impostare questa variabile su TRUE per indicare che l’elaborazione deve essere interrotta. 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 lato client e, in tal caso, il valore del parametro Cancel non viene preso in considerazione.

Osservazioni

L’implementazione client di questo metodo deve garantire che tutte le eccezioni sollevate 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 risultati imprevedibili (ad esempio, l’arresto del programma).

Vedi anche

IFRPageEvents FRPage