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.
HRESULT OnProgress(
IFRPage* Sender,
int Percentage,
VARIANT_BOOL* Cancel
);
void OnProgress(
IFRPage Sender,
int Percentage,
ref bool Cancel
);
Sub OnProgress( _
Sender As IFRPage, _
Percentage As Integer, _
ByRef Cancel As Boolean _
)
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.
[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.
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).
IFRPageEvents
FRPage